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我 有 将 平时 工作 所 司 写 成 博客 以 记录 的 习 
惯 ， 随 春 逐 渐 的 积 素 ， 终 于 可 以 形成 目前 这 样 一 
本 实战 性 的 手册 。 我 平时 在 阅读 大 量 的 Spring 相 
天 书籍 的 时 候 发 现 : 很 多 书籍 对 知识 的 讲解 一 味 
求全 求 深 ， 导致 读者 很 难 快速 掌握 某 一 项 技术 ， 
FLAVA SR ESR TT ARS Te ESCHER, RAZE 
筋 里 ， 长 至 半途 而 废 。 


所 以 本 书 的 每 个 章节 的 基本 架构 都 是 ;点睛 
+ 实战 。 


AES: 用 最 何 练 的 语言 去 手 述 当前 的 拉 术 ; 
SRA: 对 当前 技术 进行 实 成 意义 的 代码 演 
7e 
本 书 代码 的 另 一 个 特点 是 : 技术 相关 ， 业 务 


不 相关 。 和 在 本 书 的 实战 例 于 中 不 会 假设 一 个 业务 
需求 ， 然 后 让 读 痢 有 既 要 理解 技术 ， 叉 要 理解 假设 


的 业务 ， 本 书 的 目标 是 让 读者 “学 习 时 只 关注 技 
术 ， 开 发 时 只 关注 业务 ”。 


本 书 涉及 的 技术 比较 广 ， 匹 其 是 第 三 部 分 : 
实战 Spring Boot， 这 让 我 很 难 在 一 本 书 中 对 每 一 
项 技术 细 和 都 详细 说 明 ; 我 希望 本 书 能 为 读者 在 
RARER DA EMISIE, RA ETE ELAR EFT 
的 问题 时 可 以 去 学 习 特 定 技 术 的 相关 书籍 。 


Spring 在 Java EE 开 发 中 是 实际 意义 上 的 标 
准 ， 但 我 们 在 开发 Spring 的 时 候 可 能 会 过 到 以 下 
让 人 头疼 的 问题 : 
(1) 大 量 配 置 文件 的 定义 ; 
(2) 与 第 三 方 软件 整合 的 技术 问题 。 


Spring 每 个 狐 版 本 的 推出 部 以 减少 配置 作为 
目 己 的 主要 目标 ， 例 如 : 


(1) 推出 @Component、@Service ^ 
@Repository ` @Controller t ÆR E HH Bean; 


(2) 推出 @Configuration、@Bean 的 Java 配 
置 来 珍 代 xml 配 置 。 


在 脚本 语言 和 敏捷 开发 大 行 其 道 的 时 代 ， 
Java EE 的 开发 显得 尤为 守重 ， 让 人 误解 Java EEF 
发 驶 该 如 此 。Spring 在 提升 Java EE 开发 效率 的 脚 
步 上 从 未 停止 过 ， 而 Spring Booth) JE Hi ze AA Bil 
和 窗 和 划时代 意义 的 。Spring Boot 具 有 以 下 特征 : 


(1) 遵循 “习惯 优 于 配置 ?原则 ， 使 用 Spring 
Ic 需 很 少 的 配置 ， 大 部 分 时 候 可 以 使 用 默认 


(2) 项 目 快速 搭建 ， 可 无 配置 整合 第 三 方 杠 


(3) 可 完全 不 使 用 xml 配 置 ， 只 使 用 自动 配 
置 和 Java Config; 


(4) WrServlet (如 Tomcat) 容器 ， 应 用 可 
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用 jar 包 运行 (java-jar) 
(5) 运行 中 应 用 状态 的 监控 。 


虽然 Spring Boot 给 我 们 市 来 了 类 似 于 脚本 语 
言 开 发 的 效率 ， 但 Spring Boot 里 没有 使 用 任何 让 
你 意外 的 技术 ， 完 全 是 一 个 单纯 的 基于 Spring 的 
应 用 。 如 Spring Boot 的 目 动 配置 是 通过 Spring 4.x 
的 @Conditional 注 解 来 实现 的 ， 所 以 在 学 习 Spring 


Boot 之 前 ， 我 们 需要 快速 学 习 Spring 与 Spring 
MVC 的 基础 知识 。 


第 一 部 分 :所 有 睛 Spring 4.x 


快速 学 习 Spring 4.x 的 各 个 知识 点 ， 包 括 基础 
BCS BAAR Rees, MEAR H A 
置 ， 并 体会 使 用 Java 语 法 配置 所 市 来 的 便捷 。 


第 二 部 分 :点睛 Spring MVC 4.x 


快速 学 习 Spring MVC 4.1 的 各 个 知识 点 ， 
MVCHJJT RERI H AFRL 3g I 1] É 
的 ， 所 以 学 习 Spring MVC 对 Spring Boot 的 使 用 极 
AAE) o 

第 三 部 分 : 实战 Spring Boot 

这 部 分 是 整 本 书 的 核心 部 分 ， 每 个 章 世 都 会 
通过 讲解 和 实战 的 例子 来 演示 Spring Boot 在 实际 
项 目 中 遇 到 的 方方面面 的 情况 ， 真 正 达到 让 
Spring Boot 成 为 Java EE 开发 的 实际 解决 方案 。 


Spring Boot 发 布 于 2014 年 4 月 ， 根 据 知名 博 主 
Baeldung 的 调查 ， 截 至 2014 年 年 压 ， 使 用 Spring 
Boot 作 为 Spring 开发 方案 的 已 有 34.19%6， 这 是 多 人 么 
惊人 的 速度 。 


硕 望 读者 在 阅读 完 本 书后 ， 能 够 快速 符 代 现 
有 的 开发 方式 ， 使 用 Spring Boot 进 行 重 构 ， 和 大 
量 配置 与 整合 开发 说 再 见 ! 


本 书 是 我 的 第 一 本 技术 书籍 ， 主 要 目的 是 让 
读者 快速 上 手 Spring Boong RIE PEA Java EEF 
发 技术 ， 由 于 作者 水 平 有 限 ， 书 中 丝 漏 之 处 在 所 
难免 ， 芍 请 读者 批评 指正 。 


第 一 部 分 ” 扩 睛 Spring 4.x 


第 1 章 ”Spring 基础 


favo Hee)? DUAR ATE Spring hJ Ads , a 
面 上 关于 Spring 的 书籍 也 是 计 牛 序 栋 。 本 书 介 
的 Spring 4.x 不 是 对 Spring 知识 点 的 全 面 讲 解 ， " 
是 将 工作 中 党 用 的 Spring 相关 的 知识 点 罗列 出 
来 ， 以 总 睛 的 形式 (快速 讲解 + 示例 ) 让 读者 快 
速 掌握 Spring 在 开发 中 的 和 常用 知识 。 


1.1 Spring 概述 


1.1.1 Spring 的 简 史 


Spring 的 历史 网 上 有 很 多 介绍 ， 下 面 讲 下 我 
杀 历 的 Spring 发 展 的 过 程 。 


在 Spring 1.x 时 代 ， 使 用 Spring 开发 满眼 都 是 
xml 配 置 的 Bean， 随 痢 项 目的 扩大 ， 我 们 需要 把 
xml 配 置 文件 分 放 到 不 同 的 配置 文件 里 ， 那 时 候 需 
要 频 爱 地 在 开发 的 类 和 配置 文件 之 则 切换 。 


第 二 阶段 : 注解 配置 


在 Spring 2.x 时 代 ， 随 着 JDK 1.5 带 来 的 注解 支 
持 ，Spring 提 供 了 声明 Bean 的 注解 (如 
@Component ` @Service) ， 大 大 减少 了 配置 量 。 
这 时 Spring 圈 子 里 存在 着 一 种 争论 : 注解 配置 和 
xml 配 置 完 莞 哪个 更 好 ? 我 们 最 终 的 选择 是 应 用 的 
Pam (如 数据 库 配 置 ) 用 xml， 业 务 配置 用 注 
5 o 


第 三 阶段 : Java 配置 


从 Spring 3.x 到 现在 ，Spring 提 供 了 Java 配 置 
的 能 力 ， 使 用 Java 配 置 可 以 让 你 更 理解 你 配置 的 
Bean。 我 们 目前 刚好 处 于 这 个 时 代 ，Spring 4.x 和 
Spring Boot 都 推荐 使 用 Java 配 置 ， 所 以 我 们 在 本 
书 通 篇 将 使 用 Java 配 置 。 


1.1.2 ”Spring 概述 


Spring 框架 是 一 个 轻 量 级 的 企业 级 开发 的 一 
站 式 解 决 方案 。 所 请 解决 方案 束 是 可 以 基于 
Spring 解决 Java EE 开发 的 所 有 问题 。Spring 框 染 
主要 提供 了 IoC 容 器 、AOP、 数 据 访问 、Web 开 
有 发、 消息、 测试 等 相关 技术 的 文 持 。 


Spring 使 用 简单 的 POJO (Plain Old Java 
Object， 即 无 任何 限制 的 普通 Java 对 象 ) 来 进行 企 
业 级 开发 。 每 一 个 被 Spring 管理 的 Java 对 象 都 称 之 
为 Bean; 而 Spring 提供 了 一 个 IoC 容 硕 用 来 初始 化 
对 象 ， 解 雇 对 象 间 的 依 顿 管理 和 对 象 的 使 用 。 


1.Spring 的 模块 


Spring 是 模块 化 的 ， 这 意味 着 你 可 以 只 使 用 
你 需要 的 Spring 的 模块 。 如 图 1-1 所 示 。 


© Spring Framework Runtime 


Data Access/Integration Web 


JDBC WebSocket Serviet 


OXM 


: Portlet 
Transactions 


Web 


1-1 Spring 的 模块 


图 1-1 中 的 每 一 个 最 小 单元 ， Spring 都 至 少 有 
一 个 对 应 的 jar 包 。 


(1) 核心 容器 (Core Container) 


Spring-Core: 核心 工具 类 ，Spring 其 他 模块 
大 量 使 用 Spring-Core; 


Spring-Beans: Spring 定义 Bean 的 文 持 ; 


Spring-Context: 运行 时 Spring 容 矿 ; 


Spring-Context-Support: Spring fas} — 77 
包 的 集成 文 持 ; 


Spring-Expression: 使 用 表达 式 语 言 在 运行 时 
查询 和 操作 对 和 象 。 


(2) AOP 

Spring-AOP: 基于 代理 的 AOP 文 持 ; 
Spring-Aspects: 基于 AspectJ 的 AOP 文 持 。 
(3) 消息 (Messaging) 


Spring-Messaging: XH T APPA xc 
RF 


(4) Web 


Spring-Web: 提供 基础 的 Web 集 成 的 功能 ， 
在 Web 项 目 中 提供 Spring 的 容 妖 ; 


Spring-Webmvc: 提供 基于 Servlet 的 Spring 
MVC; 


Spring-WebSocket: 提供 WebSocket 功 能 :; 


Spring-Webmyv c-Portlet: tell -Portletz NITE x 
Ll 
EB o 


(5) 数据 访问 /集成 (Data 


Access/Integration) 
Spring-JDBC: 提供 以 JDBC 访 问 数据 库 的 支 
Spring-TX: 提供 编程 式 和 声明 式 的 事务 文 
Spring-ORM: 提供 对 对 象 /关系 映射 技术 的 文 
Spring-OXM: 提供 对 对 象 /xml 映 射 技术 的 支 


Spring-JMS: 提供 对 JMS 的 文 持 。 
2.Spring 的 生态 


Spring 发 展 到 现在 已 经 不 仅仅 是 Spring 框架 本 
喘 的 内 容 ，Spring 目 前 提供 了 大 量 的 基于 Spring 的 


项 目 ， 可 以 用 来 更 深入 地 降低 我 们 的 开发 难度 
提高 开发 效率 ° 


目前 Spring 的 生态 里 主要 有 以 下 项 目 ， 我 们 
gem 目 己 项 目的 需要 来 选择 使 用 相应 的 项 
4 ring Boot: 使 用 默认 开发 配置 来 实现 快速 
JF A ° 


Spring XD: 用 来 简化 大 数据 应 用 开发 。 
Spring Cloud: 为 分 布 式 系统 开发 提供 工具 
FB o 


AN 


Spring Data: 对 主流 的 关系 型 和 NoSQL 效 据 
库 的 文 持 。 


Spring Integration: 通过 消 思 机制 对 企业 集成 
模式 (EIP) 的 支持 。 


p ae Batch: 何 化 及 优化 大 量 数 据 的 批 处 理 


Spring Security: 通过 认证 和 授权 保护 应 用 。 


Spring HATEOAS: 基于 HATEOAS 原 则 简化 
REST 服 务 开发 。 


Spring Social: 与 社交 网 络 API (如 
Facebook ^ NRM ESE) 的 集成 。 


Spring AMQP: 对 基于 AMQP 的 消 居 的 文 
AP 


Spring Mobile: 提供 对 手机 设备 检测 的 功 
能 ， 给 不 同 的 设备 返回 不 同 的 页 面 的 文 持 。 


Spring for Android: 主要 提供 在 Android 上 消 
费 RESTful API 的 功能 。 


Spring Web Flow: 基于 Spring MVC 提 供 基 于 
同 导 流 程式 的 Web 应 用 开发 。 


Spring Web Services: 提供 了 基于 协议 有 限 的 
SOAP/Web 服 务 。 


Spring LDAP: 简化 使 用 LDAP 开 发 。 


Spring Session: 提供 一 个 API 及 实现 来 管理 
用 户 会 话 信息 。 


1.2 ”Spring 项 目 快速 搭建 


讲 到 项 目的 搭建 ， 也 许 有 些 读 者 使 用 的 是 通 
过 开发 工具 新 建 项 目 ， 然 后 将 项 目 所 要 依赖 的 第 
三 方 jar 包 复制 到 下 面 的 类 路 径 下 。 


我 们 现在 要 和 这 种 项 目 搭建 的 方式 说 拜拜 
了 ， 因 为 上 述 搭 建 方式 没有 第 三 方 类 库 的 依 顿 天 
系 ， 在 导入 一 个 特定 的 jar 包 时 ， 可 能 此 jar 包 还 依 
赖 于 其 他 的 jar 包 ， 其 他 的 jar 包 又 依赖 于 更 多 的 jar 
包 ， 这 也 是 我 们 平 筑 过 到 的 ClassNotFound 销 误 的 
主要 原因 。 


为 了 解决 上 述 问 题 ， 我 们 急需 引入 一 个 项 目 
构建 工具 。 目 前 主流 的 项 目 构建 工具 有 : Ant > 
Maven、Gradle 等 。 本 书 中 我 们 使 用 Maven 作 为 项 
HELE o 


1.2.1 Maven 简 介 


Apache Maven 是 一 个 软件 项 目 管理 工具 。 基 
于 项 目 对 象 模型 (Project Object Model, POM) 


的 概念 ，Maven 可 用 来 管理 项 目的 依赖 、 编 译 、 
文档 等 信息 ABA ° 


(EH Maven HE HET, SE ARMA jar 2f 
不 在 包含 在 项 目 内 ， 而 十 集 中 放置 在 用 户 目 杂 下 
Hm 


1.2.2 ”Maven 安 装 


1. 下 载 Maven 


根据 操作 系统 下 载 正确 的 Maven 碑 本 ， 并 解 
压 到 任意 目 隶 。 


Maven 下载 地 址 : 


https://maven.apache.org/download.cgi ° 
2. Er Maven 


在 系统 属性 ”~ 高 级 ~” 环境 变量 中 分 别 配置 
M2 HOME 和 Path 如 图 1.2 所 示 o 


pe. 
FERATE x 
FEEN): M2_HOME 
JHEV: EAapache-maven-3.2.2] 
RE 取消 
编辑 系统 变量 x 
变量 名 (N): Path 
FSEV: hon27\Scripts;C:\OpenBR-0.5.0-win64\bin;C:\Program Files\nodejs\%M2_HOME%\bin | 
| 确定 取消 


图 1-2 ”配置 M2 _ HOME 和 Path 
3. 测 斌 安装 


在 控制 台 输入 “mvn-v”"， 获 得 如 图 1-3 所 示 信 
FARRER ° 


i: "amd64", family: “dos” 


图 1-3 ”安装 成 功 


1.2.3 ”Maven 的 pom.xml 


Maven 是 基于 项 目 对 象 模型 的 概念 运作 的 ， 
所 以 Maven 的 项 目 都 有 mn xml 用 来 管理 项 目 
的 依赖 以 及 项 目的 编译 等 功能 


在 我 们 的 项 目 中 ， 我 们 主要 天 注 下 面 的 元 


1.dependencies 元 系 


<dependencies></dependencies>， 此 元 素 包含 
个 项 目 依赖 需要 使 用 的 <dependency> 


sien ? 

2.dependency7r 2$ 

«dependency»? «/dependency? P A38 1E 
groupId、artifactId 以 及 version 硝 定 唯 一 的 依赖 ， 
有 人 称 这 三 个 为 坐标 ， 代 人 码 如 下 。 

groupId: 组 织 的 唯一 标识 。 

artifactId: 项 目的 唯一 标识 。 

version: 项 目的 版 本 。 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-webmvc</artifactId> 


<version>4.1.5.RELEASE</version> 
</dependency> 


3. 变 量 定义 


变量 定义 : <properties></properties> 可 定义 变 


量 在 dependency 中 引用 ， 代 码 如 下 。 


«properties» «spring- 
framework.version>4.1.5.RELEASE</spring-framework.version> 
</properties> 

<dependency> 


«groupId»org.springframework«/groupId» 

<artifactId>spring-webmvc</artifactId> 

<version>${spring-framework.version}</version> 
</dependency> 


4. 编 译 插件 


Maven 近 供 了 编 详 插件 ， 可 在 编 详 插件 中 涉 
及 Java 的 编 详 级 别 ， 代 人 码 如 下 。 


<build> 
<plugins> 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler - 
plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>1.7</source> 
<target>1.7</target> 
</configuration> 
</plugin> 


</plugins> 
</build> 


5.Maven 运 作 方 式 


Maven 会 目 动 根据 dependency 中 的 依赖 配置 ， 
直接 通过 互联 网 在 Maven 中 心 库 下 载 相 天 依 赖 包 
到 .m2 目录 下 ，.m2 目 录 下 是 你 本 地 Maven 库 。 


如 果 你 不 知道 你 所 依赖 jar 包 的 dependency 坊 
么 写 的 话 ， 推 厦 到 http://mvnrepository.com 网 站 检 
E [9] 


知 Maven 中 心 库 中 没有 你 需要 的 jar 包 (如 
Oracle) ， 你 需要 通过 下 面 的 Maven 命 令 打 到 本 地 
Maven 库 后 应 用 即 可 ， 如 安装 Oracle 驱 动 到 本 地 
FE: 


mvn install:install-file -DgroupId=com.oracle "- 
DartifactId-ojdbci4" 

"-Dversion-10.2.0.2.0" "-Dpackaging=jar" " 
Dfile=D:\ojdbc14. jar" 


1.24 Spring 项 目的 搭建 


1. 基 于 Spring Tool Suite 


Spring Tool Suite (RSTS) 是 Spring 官方 推 
出 的 基于 Eclipse 的 开发 工具 ， 集 成 了 M2E (Maven 
Integration for Eclipse) ^ Spring IDE 等 插件 。 若 习 
惯 于 用 Eclipse 开发 项 目的 话 ，STS 则 十 开发 Spring 
项 目的 不 二 之 选 。 奉 你 当前 使 用 的 是 营 规 的 
Eclipse， 请 安 狼 M2E 插 件 。STS 下 载 地 址 : 
https://spring.io/tools/sts/all ° 


(1) 新 建 Maven 项 目 ， 如 图 1-4 所 示 。 


- 
(€. New Maven Project 


New Maven project M 


Select project name and location 


VlCreate a simple project (skip archetype selection) 


v| Use default Workspace location 


Add project(s) to working set 


> Advanced 


图 1-4 新 建 Maven 项 目 


(2) 输出 本 Maven 项 目的 坐标 值 ， 如 图 1-5 所 


(3) 在 STS 中 生成 如 图 1-6 所 示 结 构 的 项 目 。 


© New Maven Project 
New Maven project 


Configure project 


Artifact 


Group Id:  |com.wisely 


Artifact Id: | highlight spring4 


0.0.1-SNAPSHOT 


图 1-5 输出 坐标 值 


v {> highlight spring4 


(38 src/main/Java 


(48 src/main/resources 


(8 src/test/java 

(9 src/test/resources 

mi JRE System Library [J2SE-1.5] 
(=> src 

(= target 

im] pom.xml 


图 1-6 项 目的 结构 


(4) 修改 pom.xml。 增 加 Spring 的 依赖 ， 添 
加 编译 插件 ， 将 编译 级 别 设置 为 1.7。 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.wisely</groupId> 
<artifactId>highlight_spring4</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<properties> 
<java.version>1.7</java.version> 
</properties> 
<dependencies> 
<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-context</artifactId> 


<version>4.1.6.RELEASE</version> 
</dependency> 
</dependencies> 
<build> 
<plugins> 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler - 
plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>${java.version}</source> 
<target>${java.version}</target> 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


(5) 更 新 项 目 。 单 击 项 目 右键 
^ Maven > Update Project ^ highlight- 
spring4 ^ Maven 
Dependencies > Spring > expression- 
4.1.6RELEASE.jar， 如 图 1-7 所 示 。 


z siens ava 
(4$ src/main/resources 


(8 src/test/Java 


(48 src/test/resources 


v Bi Maven Dependencies 
Ge spring-context-4.1.6.RELEASE jar - C:\Users\wise 
spring-aop-4.1.6.RELEASE jar - C:\Users\wisely’, 


à aopalliance-1.0jar - C:\Users\wisely\.m2\reposit 
as spring-beans-4.1.6.RELEASE jar - C:\Users\wisel) 
dG spring-core-4.1.6.RELEASE jar - C:\Users\wisely\. 
ad commons-logging-1.2.,jar - C;\Users\wisely\.m2\ 
jaa spring-expression-4.1.6.RELEASE jar - C:\Users\y 
> mà JRE System Library [JavaSE-1.7] 
^ B src 
& target 
[m] pom.xml 


图 1-7 更 新 项 目 
(6) 依赖 树 查 看 ， 如 图 1-8 所 示 。 


[vj highlight spring4/pom.xml 23 = rj 


Dependency Hierarchy [test] Filter: || livy| & 
Dependency Hierarchy 日 | 14, w [3] Resolved Dependencies Eo 加 
v 日 spring-context : 4.1.6.RELEASE [compile] [n aopalliance : 1.0 [compile] 
v © spring-aop : 4.1.6.RELEASE [compile] © commons-logging : 1.2 [compile] 
(3 aopalliance : 1.0 [compile] 日 spring-aop : 4.1.6.RELEASE [compile] 
C) spring-beans : 4.1.6.RELEASE (omitted for cc © spring-beans : 4.1.6.RELEASE [compile] 
© spring-core : 4.1.6.RELEASE (omitted for con Ds ntext : 4.1.6.RELEASE [compile] 
v ©) spring-beans : 4.1.6.RELEASE [compile] A 


pring-co 
口 spring-core : 4.1.6.RELEASE [compile] 
Cj spring-core : 4.1.6.RELEASE (omitted for con Gi soring-expression : AMGRELEASE [compile] 
v © spring-core : 4.1.6.RELEASE [compile] 
commons-logging : 1.2 [compile] 
v © spring-expression : 4.1.6.RELEASE [compile] 

© spring-core : 4.1.6.RELEASE (omitted for con 


Overview Dependencies Dependency Hierarchy Effective POM pom.xml 


Eh-8 ”依赖 树 查 看 
2. 基 于 IntelliJ IDEA 搭 建 


IntelliJ IDEA 是 Java 最 优秀 的 开发 工具 : 功能 
全 面 、 提 示 智 能、 开发 不 卡 顿 、 新 技术 支持 快 。 


IntelliJ IDEA 分 为 社区 版 和 商业 版 ， 社 区 版 免 
费 ， 商 业 版 功能 强大 。 商 业 版 提供 30 天 的 试用 。 


IntelliJ IDEA 下 载 地 址 : 


https://www.jetbrains.com/idea/download/ ° 


(1) 新 建 Maven 项 目 。 单 击 
File > New ^ Project 2 Maven， 如 图 1-9 所 示 。 


(2) 输入 Maven 项 目 坐 标 值 ， 如 图 1-10 所 


(3) 选择 存储 路 径 ， 如 图 1-11 所 示 。 


Jl New Project x | 


图 1-9 新 建 Maven 项 目 


引 New project x 


图 1-10 输入 坐标 值 


图 1-11 选择 存储 路 径 


(4) 修改 pom.xml 文 件 ， 使 用 上 例 的 pom.xml 
文件 内 容 ，IDEA 会 开局 目 动 导 入 Maven 依 赖 包 功 
能 ， 如 图 1-12 所 示 。 


v Lahightlight spring4 idea 


E Ideg 


[2 
p 
P. 
5 
F 
h 
b 
DH 


图 1-12 ”开启 自动 导入 Maven 功 能 


(5) 依赖 树 查 看 ， 如 图 1-13 所 示 。 


= 
-3 

a 

s | 
iS 

oO 
o 
E 
D] 


图 1-13 ”依赖 树 查 看 
3. 基 于 NetBeans 搭 建 


NetBeansÆ Oracle E J f HB JJava7T A LA , 
下 载 地 址 如 下 : https:;//netbeans.org/downloads/ ° 


(1) 新 建 Maven 项 目 ， 如 网 1-14 所 示 。 


Q E31): 


9 (c): : 
f U jarat Java 应 用 程序 
: ~ Java EE an —- 
i HIMLS Web 应 用 程 
AD Java Me EAE Hm gu 
iB ee Cara 企业 应 用 程序 
amm a 
0SGi 
| PHP NetBeans 模块 
i one | D amet 应 用 程序 
f C/C++ POM Ing 
H y NetBeans 模块 m 基于 原型 的 项 目 
aD 样 例 D 基于 现 有 POM 的 项 目 


3x (D): 
紫 功 能 尚未 启用 。 按 “下 一 步 ” 可 将 其 激活 。 


使 用 Maven 的 简单 Java SE 应 用 程序 。 


图 1-14 新建 Maven 项 目 


(2) 输入 Maven 坐 标 ， 如 图 1-15 所 示 。 


O E Java 应 用 程序 


za 名 称 和 位 置 
选择 项 目 AEAU):  hightlight springd 
MERTE): |C: ears vri asly Dormments UetBeens?rojests LARO... 


项 目 文件 夹 (D): |wisely\Documents \NetBeansProjects\hightlight_spring4 


工件 ma): hightlight springt 


组 ID(G): com.visely 


Wd): 1. O-SHAPSHOT 


t): EE wixely. bi gels ht spring! 


[ ako || sms 


图 1-15 输入 Maven 坐 标 


(3) 更 新 pom.xml]， 如 图 1-16 所 示 。 


S highlight spring4 

昌国 源 包 

| BE co. wisely. hightlight_spring4 

: i 依赖 关系 
由 - ins spring-context—4. 1.6. RELEASE. jar 
由 la aopalliance-1.0. jar 
| 3J comons-logging-1.2. jar 

回 spring-aop-4. 1.6. RELEASE. jar 


四- 
H- Els spring-beans-4. 1.6. RELEASE. jar 
由 - la spring-core—4. 1.6. RELEASE. jar 


: 由 - spring-expression-á. 1.6. RELEASE. jar 
Tie Jos RBA 

«SD Jpx 1.8 GW 

a ug mazi 


图 1-16 更 新 pom.xml 
(4) 依赖 树 查 看 ， 如 图 1-17 所 示 。 


[5] pom. xml [highlight springd] X 
源 Be | 有 效 历史 记录 | 显示 图 形 € a 


commons-logging aopalliance 
12 1.0 


spring-core 
4.1.6.RELEASE 


spring-expression 
4.1.6.RELEASE 


spring-context 
4.1.6.RELEASE 


9 highlight spring4 
0.0.1-SNAPSHO! 


图 1-17 依赖 树 查 看 


1.3 Spring 基础 配置 


Spring 框 架 本 映 有 四 大 原则 : 
1) 使 用 POJO 进 行 轻 量 级 和 最 小 侵入 式 开 
n 2) 通过 依赖 注入 和 基于 接口 编程 实现 松 硝 
3) 通过 AOP 和 默认 习惯 进行 声明 式 编程 。 


m 使 用 AOP 和 模板 (template) 减少 模式 化 


Spring 所 有 功能 的 设计 和 实现 都 生 基 于 此 四 
大 原则 的 。 


1.3.1 依赖 注入 


1.53 8 


我 们 经 常 说 的 控制 翻转 (Inversion of Control- 
IOC) 和 依赖 注入 (dependency injection-DI) 在 
Spring 环境 下 是 等 同 的 概念 ， 控 制 翻转 是 通过 依 
瑚 注入 实现 的 。 所 请 依赖 注入 指 的 是 容 硕 负责 创 
建 对 象 和 维护 对 象 间 的 依赖 天 系 ， 而 不 是 通过 对 
RAS fm Bp SIS qu B eI e 


TOS ABUSE H BUE SR, AIN T — 
种 “组 合 ” 的 理念 。 如 琳 你 希望 你 的 类 具备 某 项 功 
能 的 时 候 ， 征 继承 目 一 个 具有 此 马 能 的 父 拓 好 
UE? 还 是 组 合 男 外 一 个 具有 这 个 功能 的 类 好 呢 ? 
答案 是 不 吝 而 喻 的 ， 继 承 一 个 父 类 ， 子 类 将 与 父 
类 粳 合 ， 组 合 男 外 一 个 类 则 使 粳 合 度 大 大 降低 。 


Spring IoC 容 器 (ApplicationContext) 负责 创 
建 Bean， 并 通过 容 兹 将 功能 类 Bean 注 入 到 你 需要 
HBean 中 。Spring 提 供 使 用 xml、 注 解 、Java 配 
置 、groovy 配 置 实现 Bean 的 创建 和 注入 。 


无 论 古 xml 配 置 、 注 解 配 置 还 是 Java 配 置 ， 都 
伞 称 为 配置 元 数据 ， 所 谓 元 数据 即 描述 数据 的 数 
据 。 元 数据 本 刁 不 有 具备 任何 可 执行 的 能 力 ， 只 能 
通过 外 界 代 码 来 对 这 些 元 数据 行 解析 后 进行 一 些 
有 意义 操作 。Spring 容 器 解析 这 些 配 置 元 数据 进 
行 Bean 初 始 化 、 配 置 和 管理 依 顿 。 


FS HHBeanBJ 3:88 : 


。@Component 组 件 ， 没 有 明确 的 角色 。 

。(DService 在 业务 逻辑 层 (service) 使 用 。 

。@Repository 在 数据 访问 层 《dao 层 ) 使 用 。 

。@Controller 在 展现 层 (MVC -> Spring MVC) 
使 用 。 


TEA Beanhit fE, AIEO PO e 
e @Autowired: Spring 提供 的 注解 。 
e @Inject: JSR-330 提 供 的 注解 。 
e @Resource: JSR-250 提 供 的 注解 。 
@Autowired、@Inject、@Resource 可 注解 在 
set 方 法 上 或 者 属性 上 ， 笔 着 习惯 注解 在 属性 上 ， 
优 扣 是 代码 更 少 、 层 次 更 清晰 。 
在 本 万 演示 基于 注解 的 Bean 的 初始 化 和 依赖 


TEA, Spring isit H 
AnnotationConfigApplicationContext ° 


2. 示 例 


(1) 编写 功能 类 的 Bean 。 


package com.wisely.highlight spring4.chi.di; 
import org.springframework.stereotype.Service; 
@Service //1 
public class FunctionService { 
public String sayHello(String word) { 
return "Hello " + word +" !"; 


} 


代码 解释 


(使 用 @Service 注 解 声 明 当 前 FunctionService 


类 是 Spring 管 理 的 一 个 Bean。 其 中 ， 使 用 
CN ^ @Service ^ qure i 
@Controller 是 等 歼 的 ， 可 根据 需 j 


(2) 使 用 功能 类 的 Bean 。 


package com.wisely.highlight spring4.chi.di; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Service; 
QService //1 
public class UseFunctionService { 

QAutowired //2 

FunctionService functionService; 


public String SayHello(String word)( 


return functionService.sayHello(word); 


} 


代码 解释 


DEH Serviced: f Fs Hj 24 gj 


UseFunctionService 类 十 Spring 管理 的 一 个 Bean ° 


0) 使 用 @Autowired 将 FunctionService 的 实体 
Bean 注 入 到 UseFunctionService 中 ， 放 
UseFunctionService 具 备 FunctionService 的 功能 ， 
此 处 使 用 JSR-330 的 @Inject 注 解 或 者 JSR-250 的 


@Resource 注 解 是 等 效 的 。 


(3) 配置 类 。 


package com.wisely.highlight spring4.chi.di; 

import 
org.springframework.context.annotation.ComponentScan; 
import 
org.springframework.context.annotation.Configuration; 
QConfiguration //1 

QComponentScan("com.wisely.highlight spring4.chi.di") //2 
public class DiConfig { 


} 
代码 解释 


@@Configuration 声 明 当 前 类 是 一 个 配置 类 ， 
在 后 面 1.3.2 廊 的 Java 配 置 中 有 更 详细 的 说 明 ; 


使 用 @ComponentScan， 目 动 扫 摘 包 名 下 上 所 
有 使 用 @Service、@Component、@Repository 和 
@Controller 的 类 ， 并 注册 为 Bean 。 


package com.wisely.highlight spring4.chi.di; 
import 
org.springframework.context.annotation.AnnotationConfigAppl 
icationContext; 
public class Main ( 

public static void main(String[] args) { 

AnnotationConfigApplicationContext context - 
new 

AnnotationConfigApplicationContext(DiConfig.class); //1 


UseFunctionService useFunctionService - 
context.getBean(UseFunctionService.class); //2 


System.out.println(useFunctionService.SayHello("di")); 


context.close(); 


代码 解释 


中 使 用 AnnotationConfigApplicationContext 作 
为 Spring 容 闫 ， 授 受 输入 一 个 配置 类 作为 参数 ; 


(2) 获 得 声明 配置 的 UseFunctionService 的 
Bean ? 


结果 如 图 1-18 所 示 。 


六 月 69，2815 3:03:50 TTorg.spri 
信息 : Refreshing org.springframe 
Hello world ! 


X809, 2015 3:03:50 Forg.spri 
æa: Closing org.springframewo 


图 1-18 运行 结果 
1.3.2 Javal E 
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Java 配 置 定 Spring 4.x 推 荐 的 配置 方式 ， 可 以 
完全 替代 xm] 配 置 ，Java 配 置 也 是 Spring Boot 推 荐 
的 配置 方式 。 


Java 配 置 是 通过 @Configuration 和 @Bean 来 实 
现 的 。 


。@Configuration 声 明 当 前 类 是 一 个 配置 类 ， 相 
当 于 一 个 Spring 配置 的 xml 文 件 。 

。@Bean 注 解 在 方法 上 上， 声明 当前 方法 的 运 回 值 
为 一 个 Bean 。 


本 书 通 篇 使 用 Java 配 置 和 注解 混合 配置 。 何 
时 使 用 Java 配 置 或 者 注解 配置 呢 ? 我 们 主要 的 原 
则 是 : 全 局 配置 使 用 Java 配 置 《如 数据 库 相 关 配 
置 、MVC 相 天 配置 ， 业 务 Bean 的 配置 使 用 注解 
配置 (@Service ^ @Component ` (QRepository ^ 
@Controlle) 


本 只 演示 人 简单 的 Java 配 置 ， 全 书 各 个 章节 
都 会 AJ Eva ERA 


2. 示 例 
(1) 编写 功能 类 的 Bean 。 


package com.wisely.highlight spring4.chi.javaconfig; 
//1 
public class FunctionService { 
public Serang sayHello(String ms 
return "Hello " + word +" 


j 
j 


代码 解释 
(此 处 没有 使 用 @Service 声 明 Bean 。 
(2) 使 用 功能 类 的 Bean 。 


package com.wisely.highlight spring4.chi.javaconfig; 


import 

com.wisely.highlight spring4.chi.javaconfig.FunctionService 
//1 

public class UseFunctionService { 


//2 
FunctionService functionService; 


public void setFunctionService(FunctionService 


functionService) { 
this.functionService = functionService; 


} 


public String SayHello(String word){ 
return functionService.sayHello(word); 


} 


代码 解释 

QD 此 处 没有 使 用 @Service 声 明 Bean 。 

G@) 此 处 没有 使 用 @Autowired 注 解 注入 Bean。 
(3) 配置 类 。 


package com.wisely.highlight spring4.chi.javaconfig; 


import org.springframework.context.annotation.Bean; 
import 
org.springframework.context.annotation.Configuration; 


QConfiguration //1 
public class JavaConfig 1 
QBean //2 


public FunctionService functionService(){ 
return new FunctionService(); 


j 


QBean 
public UseFunctionService useFunctionService(){ 
UseFunctionService useFunctionService - new 
UseFunctionService(); 


useFunctionService.setFunctionService(functionService());// 
3 
return useFunctionService; 


j 


// QBean 
// public UseFunctionService 
useFunctionService(FunctionService functionService)( //4 


Z7 UseFunctionService useFunctionService - new 
UseFunctionService(); 

// 
useFunctionService.setFunctionService(functionService); 
// return useFunctionService; 

// } 

} 


代码 解释 


(使 用 @Configuration 注 解 表明 当前 类 是 一 个 
配置 类 ， 这 意味 痢 这 个 类 里 可 能 有 0 个 或 者 多 个 
@Bean 注 解 ， 此 处 没有 使 用 包 扫 摘 ， 是 因为 所 有 
的 Bean 都 在 此 关中 定义 了 。 


GO 使 用 @Bean 注 解 声明 当前 方法 
FunctionService 的 返回 值 是 一 个 Bean，Bean 的 各 
称 是 方法 和 名。 


G@) 注 入 FunctionService 的 Bean 时 候 和 直接 调用 


functionService () 。 


(4) 男 外 一 种 注入 的 方式 ， 直 接 将 
FunctionService 作 为 参数 给 useFunctionService 
O ， 这 也 是 Spring 容 妖 提 供 的 极 好 的 功能 。 在 
Spring 容 絮 中 ， 只 要 容器 中 存在 某 个 Bean， 束 可 
以 在 另外 一 个 Bean 的 声明 方法 的 参数 中 写 入 。 


(4) 运行 。 


package com.wisely.highlight spring4.chi.javaconfig; 


import 


org.springframework.context.annotation.AnnotationConfigAppl 


icationContext; 


public class Main ( 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(JavaConfig.class); 


UseFunctionService useFunctionService - 
context.getBean(UseFunctionService.class); 
System.out.println(useFunctionService.SayHello("java 


config")); 


context.close(); 


结果 如 图 1-19 所 示 。 


A809, 2015 3:03:09 Forg.springfre 
me: Refreshing org.springframework. 


Hello java config ! 
*7A@9, 2015 3:03:09 Torg.springfre 
me: Closing org.springframework.con 


图 1-19 运行 结果 
1.3.3 AOP 
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AOP: I&[5] JI ATE, THX Toom mna 
编程 。 


Spring 有 的 AOP 的 存在 目的 是 为 了 解 厢 。AOP 
可 以 让 一 组 类 共享 相同 的 行为 。 在 OOP 中 只 能 通 
过 继承 类 和 实现 接口 ， 来 使 代码 的 耦合 度 增 强 ， 
日 类 继承 只 能 为 单 继承 ， 阻 碍 更 多 行为 添加 到 一 
ZAR EF, AOP*qTEK f OOPRIA Æ ° 


Spring 文 持 Aspect 的 注解 式 切 面 编 程 。 
(1) 使 用 @Aspect 声 明 是 一 个 切面 。 


(2) 使 用 @After、@Before、@Around 定 义 
S advice ， 可 直接 将 拉夫 规则 ( 切 点 ) 作 


(3) 其 中 四 After、@Before、@Around 参 数 
的 拦截 规则 为 切 点 (PointCut) ， 为 了 使 切 点 复 
用 ， 可 使 用 @PointCut 专 门 定义 拦截 规则 ， 然 后 在 
@After、@Before、@Around 的 参数 中 调用 。 


(4) 其 中 符合 条 件 的 每 一 个 被 拦截 处 为 连接 
点 (JoinPoint) 
本 太 示 例 将 演示 基于 注解 拦截 和 基于 方法 规 
则 拦 稚 两 种 方式 ， 读 示 一 种 模拟 记录 操作 的 日 志 
系统 的 实现 。 其 中 注解 式 搓 截 能 够 很 好 地 控制 要 
拦截 的 粒度 和 获得 更 丰富 的 信息 ，Spring 本 上 刁 在 
事务 处 理 (@Transcational) 和 数据 缓存 
(@Cacheable 等 ) 上 面 都 使 用 此 种 形式 的 拦截 。 


2. 示 例 


(1) 添加 spring aop 支 持 及 Aspect 依 赖 。 


<!-- Spring aop 


MHF --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-aop 


</artifactId> 
<version>4.1.6.RELEASE</version> 
</dependency> 
<!-- aspect). 


支持 --> 


<dependency> 
«groupId»org.aspectj«/groupId» 
<artifactId>aspectjrt</artifactId> 
<version>1.8.5</version> 
</dependency> 
<dependency> 
«groupId»org.aspectj«/groupId» 
<artifactId>aspect jweaver 


</artifactId> 
<version>1.8.5</version> 
</dependency> 


(2) 编写 拦截 规则 的 注解 。 


package com 


import java 
import java 
import java 
import java 
import java 


.Wisely.highlight spring4.ch1.aop; 


.lang. 
.lang. 
.lang. 
.lang. 
.lang. 


annotation. 
annotation. 
annotation. 
annotation. 
annotation. 


QTarget(ElementType.METHOD) 
QRetention(RetentionPolicy.RUNTIME) 


QDocumented 


public Qinterface Action ( 
String name(); 


j 


代码 解释 


Documented; 
ElementType; 
Retention; 
RetentionPolicy; 
Target; 


这 里 讲 下 注解 ， 注 解 本 吴征 没有 功能 的 ， 束 
和 xml 一 样 。 注 解 和 xml 都 是 一 种 元 数据 ， 元 数据 
印 解 释 数据 的 数据 ， 这 驶 是 所 谓 配 置 。 


注解 的 功能 来 自用 这 个 注解 的 地 方 。 
(3) 编写 使 用 注解 的 被 拦截 类 。 


package com.wisely.highlight spring4.chi.aop; 
import org.springframework.stereotype.Service; 


@Service 

public class DemoAnnotationService { 
@Action(name=" 注 解 式 拦 截 的 add 操 作 ") 
public void add(){} 


(4) 编写 使 用 方法 规则 被 拦截 类 。 


package com.wisely.highlight spring4.chi.aop; 
import org.springframework.stereotype.Service; 
@Service 
public class DemoMethodService { 

public void add(){} 


(5) 编写 切面 。 


package com.wisely.highlight spring4.chi.aop; 


import java.lang.reflect.Method; 


import org.aspectj.lang.JoinPoint; 

import org.aspectj.lang.annotation.After; 

import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.Before; 
import org.aspectj.lang.annotation.Pointcut; 
import org.aspectj.lang.reflect.MethodSignature; 
import org.springframework.stereotype.Component; 


QAspect //1 
QComponent //2 
public class LogAspect { 


QPointcut("Qannotation(com.wisely.highlight spring4.chi.aop 
.Action)") //3 
public void annotationPointCut(){}; 


QAfter("annotationPointCut()") //4 
public void after(JoinPoint joinPoint) { 

MethodSignature signature - (MethodSignature) 
joinPoint.getSignature(); 

Method method - signature.getMethod(); 

Action action - 
method.getAnnotation(Action.class); 

System.out.printLn(" 注 解 式 拦截 " + 
action.name()); //5 


j 


QBefore("execution(* 
com.wisely.highlight spring4.chi.aop.DemoMethodService.* 
(..))") //6 
public void before(JoinPoint joinPoint){ 

MethodSignature signature - (MethodSignature) 
joinPoint.getSignature(); 

Method method - signature.getMethod(); 

System,out,println(" 方 法 规则 式 拦 
截 , "+method.getName()); 


j 


代码 解释 


通过 @Aspect 注 解 声 明 一 个 切面 。 


(23833 (9 Componenti E ILE] TRE BY Spring as 
管理 的 Bean ° 


(3) 通 过 @PointCut 注 解 声 明 切 点 


(4 通过 @After 注 解 声 明 一 个 建言 ， 并 使 用 
@PointCut 定 义 的 切 点 。 


通过 反射 可 获得 注解 上 的 属性 ， 然 后 做 日 
jo RARER TE, PERAE ° 


(9) 通 过 @Before 广 解 声 明 一 个 建言 ， 此 建言 直 
接 使 用 拦截 规则 作为 参数 。 


(6) 配置 类 。 


package com.wisely.highlight spring4.chi.aop; 


import 
org.springframework.context.annotation.ComponentScan; 
import 
org.springframework.context.annotation.Configuration; 
import 
org.springframework.context.annotation.EnableAspectJAutoPro 
Xy, 


QConfiguration 

QComponentScan("com.wisely.highlight spring4.chi.aop") 
QEnableAspectJAutoProxy //1 

public class AopConfig { 


代码 解释 


y TJ 
使 用 @EnableAspectUJAutoProxy 注 解 开 局 
à M TT 
Spring 对 AspectJ 代 理 的 支持 。 
VS 4 
(7) 运行 。 
package com.wisely.highlight spring4.chi.aop; 
import 
org.springframework.context.annotation.AnnotationConfigAppl 
icationContext; 
public class Main ( 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 


AnnotationConfigApplicationContext(AopConfig.class); //1 


DemoAnnotationService demoAnnotationService - 
context.getBean(DemoAnnotationService.class); 


DemoMethodService demoMethodService - 
context.getBean(DemoMethodService.class); 


demoAnnotationService.add(); 
demoMethodService.add(); 


context.close(); 


结果 如 图 1-20 所 示 。 


GJ Console $3 


«terminated» Main (11) [Java Application] C 
A89, 2015 3:02:11 T*org.springfrar 
me: Refreshing org.springframework.dq 


mel FeteeHhaddae 

FsMiseR, add 

*AAO@9, 2015 3:02:11 Forg.springtra 
me: Closing org.springtramework. cont 


图 1-20 “运行 结果 


第 2 章 Spring Hd BG EL 
2.1 Beanl'JScope 


2.1.1 AIA 


Scope 描 述 的 是 Spring 容器 如 何 新 建 Bean 的 实 
例 的 。Spring 的 Scope 有 以 下 几 种 ， 通 过 @Scope 注 
解 来 实现 。 


(1) Singleton: 一 个 Spring 容 需 中 只 有 一 个 
Bean 的 实例 ， 此 为 Spring 的 默认 配置 ， 全 容 句 共享 
一 个 实例 。 


(2) Prototype: 每 次 调用 新 建 一 个 Bean 的 实 
例 。 


(3) Request: Web 项 目 中 ， 给 每 一 个 http 
request3jr && — 1 BeanSz fill ° 


(4) Session: Web 项 目 中 ， 给 每 一 个 http 
sessioni && — “Beant fill ° 


(5) GlobalSession: 这 个 只 在 portal 应 用 中 有 
用 ， 给 每 一 个 global http session 新 建 一 个 Bean 实 
例 。 


另外 ， 在 Spring Batch 中 还 有 一 个 Scope 是 使 用 
@StepScope， 我 们 将 在 批 处 理 一 市 介绍 这 个 
Scope ? 


本 例 人 简单 演示 默认 的 singleton 和 Prototype， 分 
别 从 Spring 容器 中 获得 2 次 Bean， 判 断 Bean 的 实例 
征 合 相 等 。 


2.1.2 “示例 


(1) 编写 Singleton 的 Bean 。 


package com.wisely.highlight spring4.ch2.scope; 
import org.springframework.stereotype.Service; 


@Service //1 
public class DemoSingletonService { 


j 


代码 解释 
认为 Singleton， 相 当 于 @Scope 


(“singleton”) ° 


(2) 编写 Prototype 的 Bean。 


package com.wisely.highlight spring4.ch2.scope; 


import org.springframework.context.annotation.Scope; 
import org.springframework.stereotype.Service; 


QService 
QScope("prototype")//1 
public class DemoPrototypeService { 


) 
代码 解释 
(声明 Scope 为 Prototype 。 
(3) 配置 类 。 


package com.wisely.highlight spring4.ch2.scope; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


QConfiguration 


QComponentScan("com.wisely.highlight spring4.ch2.scope") 
public class ScopeConfig { 


j 


(4) 运行 。 


package com.wisely.highlight spring4.ch2.scope; 


import 
org.springframework.context.annotation.AnnotationConfigAppli 
cationContext; 


public class Main ( 


public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(ScopeConfig.class); 


DemoSingletonService s1 = 

context.getBean(DemoSingletonService.class); 
DemoSingletonService s2 - 

context.getBean(DemoSingletonService.class); 


DemoPrototypeService p1 = 
context.getBean(DemoPrototypeService.class); 

DemoPrototypeService p2 - 
context.getBean(DemoPrototypeService.class); 


System.out.printlLln("s1 与 S2 是 否 相等 : "+s1.equals(s2)); 
System.out.printlLn("p1 与 p2 是 否 相等 : "+p1.equals(p2)); 


context.close(); 


结果 如 图 2-1 所 示 。 


E Console 23 ri Markers "i p 


«terminated » Main (12) [Java Appl 


A509, 2015 3:01:12 F+org.sp 
me: Refreshing org.springfra 
s15s2£28S- true 

plsp2##8s: false 

*AO9, 2015 3:01:12 Frorg.sp 
m2: Closing org.springframe 


图 2-1 运行 结果 


22 Spring EL 和 资源 调用 
2.2.1 ”点睛 
Spring EL-Spring 表 达 式 语言 ， 文 持 在 xml 和 注 
解 中 使 用 表达 式 ， 类 似 于 JSP 的 EL 表达 式 语言 
Spring 开 发 中 经 常 涉及 调用 各 种 资 es 
包含 普通 文件 、 网 址 、 配 置 文件 、 系 统 环 境 变 
等 ， 我 们 可 以 使 用 Spring 的 表达 式 语言 实 现 资源 的 
注入 。 
Spring 主 要 在 注解 @Value 的 参数 中 使 用 表达 


本 厄 演 示 实 现 以 下 儿 种 情况 : 
(1) 注入 普通 字符 ; 

(2) 注入 操作 系统 属性 ; 

(3) 注入 表达 式 运算 结果 ; 


(4) 注入 其 他 Bean 的 属性 ; 
(5) 注入 文件 内 容 ; 
(6) 注入 网 址 内 容 ; 
(7) 注入 属性 文件 。 


2.2.2 ”示例 


(1) 准备 ， 增 加 commons-io 可 简化 文件 相关 
EU ， 本 例 中 使 用 commons-io 将 file 转 换 成 字符 


<dependency> 
«groupId»commons-io«c/groupId» 
<artifactId>commons -io</artifactId> 
<version>2.3</version> 
</dependency> 


7£com.wisely.highlight_spring4.ch2.el@, F XTE 
test.txt， 内 容 随意 。 


在 com.wisely.highlight_spring4.ch2.el] 包 下 新 建 
test.properties, [AUI P: 


book.author-wangyunfei 
book.name-spring boot 


(2) 需 被 注入 的 Bean 。 


package com.wisely.highlight spring4.ch2.e1; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Service; 


QService 
public class DemoService { 
@value(" 其 他 类 的 属性 ") //1 


private String another; 


public String getAnother() { 
return another; 


public void setAnother(String another) { 
this.another - another; 


j 


代码 解释 
gd 此 处 为 注入 普通 字符 串 
(3) 演示 配置 类 。 


package com.wisely.highlight spring4.ch2.e1l; 


import org.apache.commons.io.IOUtils; 

import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.beans.factory.annotation.Value; 
import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
import 
org.springframework.context.annotation.PropertySource; 
import 
org.springframework.context.support.PropertySourcesPlacehold 


erConfigurer; 
import org.springframework.core.env.Environment; 
import org.springframework.core.io.Resource; 


QConfiguration 

QComponentScan("com.wisely.highlight spring4.ch2.el") 
QPropertySource("classpath:com/wisely/highlight spring4/ch2/ 
el/test.properties")//7 

public class ElConfig { 


QValue("I Love You!") //1 
private String normal; 


@Value("#{systemProperties['os.name']}") //2 
private String osName; 


@Value("#{ T(java.lang.Math).random() * 100.0 }") //3 
private double randomNumber; 


@Value("#{demoService.another}") //4 
private String fromAnother; 


QValue("classpath:com/wisely/highlight spring4/ch2/el/test.t 
xt") S75 
private Resource testFile; 


@Value("http://www.baidu.com") //6 
private Resource testUrl; 


@Value("${book.name}") //7 
private String bookName; 


@Autowired 
private Environment environment; //7 


@Bean //7 
public static PropertySourcesPlaceholderConfigurer 
propertyConfigure() { 
return new PropertySourcesPlaceholderConfigurer(); 


j 


public void outputResource() ( 


try { 
System.out.println(normal); 


System.out.println(osName); 
System.out.println(randomNumber); 
System.out.println(fromAnother); 


System.out.println(IOUtils.toString(testFile.getInputStream( 


))) 


System.out.println(IOUtils.toString(testUrl.getInputStream() 
)); 


System.out.println(bookName); 


System.out.println(environment.getProperty("book.author")); 
} catch (Exception e) { 
e.printStackTrace(); 


代码 解释 

QD 注入 普通 字符 串 。 
注入 操作 系统 属性 
(3 注入 表达 式 结 果 。 
(4) 注 入 其 他 Bean 属 性 。 
HEA SFE ° 
(9 注入 网 址 资源 。 


COHEABO EXE 9 


注入 配置 配件 需 使 用 @PropertySource 指 定 文 
件 地 址 ， 若 使 用 @Value 注 入 ， 则 要 配置 一 个 
PropertySourcesPlaceholderConfigurertyBean : ° TE 


X. @Value ("${book.name}") 使 用 的 是 “$”， 而 
不 是 “#”。 


注入 Properties 还 可 从 Environment 中 获得 。 


package com.wisely.highlight spring4.ch2.e1; 
import 
org.springframework.context.annotation.AnnotationConfigAppli 
cationContext; 
public class Main ( 

public static void main(String[] args) { 

AnnotationConfigApplicationContext context - 
new 


AnnotationConfigApplicationContext(ResourceConfig.class); 


ElConfig resourceService - 
context.getBean(ElConfig.class); 


resourceService.outputResource( ); 


context.close(); 


结果 如 图 2-2 所 示 。 


*A09, 2015 3:00:06 F+org.springfra 
æa: Refreshing org.springframework.q 
I Love You! 

Windows 8.1 

45.883449407685504 

其 好 类 的 所 性 

HERE 


<!DOCTYPE html»«!--STATUS OK--»«html 


<style index-"index" id-"css index" 
.be tuiguang weishi{width:56px;heigh 
#1lk{margin:33px @}#1lk span{font:14px 
.5_ipt_wr.bg,.s_btn_wr.bg,#su.bg{bac 
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图 2-2 ”运行 结 


2.3 Bean 的 初始 化 和 销毁 


2.3.1 点睛 


在 我 们 实际 开发 的 时 候 ， 经 音 会 遇 到 在 Bean 
在 使 用 之 前 或 者 之 后 做 些 必要 的 操作 ，Spring 对 
Bean 有 的 生命 周期 的 控 作 提供 了 文 持 。 在 使 用 Java 配 
置 和 注解 配置 下 近 供 如 下 两 种 方式 : 


(1) Java 配 置 方式 : 使 用 @Bean 的 initMethod 
和 destroyMethod 〈 相 当 于 xml 配 置 的 init-method 和 
destory-method) ° 


(2) 注解 方式 : 利用 JSR-250 的 
(QPostConstruct4ll (9 PreDestroy ° 


2.3.2 HRS 


(1) 增加 JSR250 支 持 。 


<dependency> 
«groupId»javax.annotationc/groupId» 
<artifactId>jsr250-api 


«/artifactId» 
«version»1.0«/version» 
«/dependency» 


(2) 使 用 @Bean 形 式 的 Bean 。 


package com.wisely.highlight spring4.ch2.prepost; 
public class BeanWayService { 
public void init(){ 
System.out.println("QBean-init-method"); 


public BeanWayService() { 
super(); 
System.out.println(" 初 始 化 构造 函数 - 
BeanWayService"); 


} 

public void destroy(){ 
System.out.println("QBean-destory-method"); 

} 


(3) 使 用 JSR250 形 式 的 Bean。 


package com.wisely.highlight spring4.ch2.prepost; 


import javax.annotation.PostConstruct; 
import javax.annotation.PreDestroy; 


public class JSR250WayService { 
QPostConstruct //1 
public void init(){ 
System.out.println("jsr250-init-method"); 


} 

public JSR250WayService() { 
super(); 
System,out,println(" 初 始 化 构造 函数 -JSR250WayService" ) ; 


QPreDestroy //2 
public void destroy(){ 
System.out.println("jsr250-destory-method"); 


代码 解释 


@@PostConstruct， 在 构造 函数 执行 完 之 后 执 
行 。 


@@PreDestroy， 在 Bean 销 明之 前 执行 。 


(4) 配置 类 。 


package com.wisely.highlight spring4.ch2.prepost; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


QConfiguration 
QComponentScan("com.wisely.highlight spring4.ch2.prepost") 
public class PrePostConfig { 


@Bean(initMethod="init", destroyMethod="destroy") //1 
BeanWayService beanWayService()( 

return new BeanWayService(); 
} 


QBean 

JSR250WayService jsr250WayService()( 
return new JSR250WayService(); 

} 


代码 解释 


@OinitMethod 和 destroyMethod 指 定 
BeanWayService 关 的 init 和 destroy 方 法 在 构造 之 
后 、Bean 销 毁 之 前 执行 。 


s — 


(5) 运行 。 


package com.wisely.highlight spring4.ch2.prepost; 


import 
org.springframework.context.annotation.AnnotationConfigAppli 
cationContext; 


public class Main { 


public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(PrePostConfig.class); 


BeanWayService beanWayService - 
context.getBean(BeanWayService.class); 

JSR250WayService jsr250WayService - 
context.getBean(JSR250WayService.class); 


context.close(); 


结果 如 图 2-3 所 示 。 


*A09, 2015 2:49:44 Torg.springfram 
me: Refreshing org.springframework.con 
netasan- BeanWayService 
@Bean-init-method 

meee R-ISRA50WayService 


jsr250-init-method 

*A09, 2015 2:49:44 Feorg.springframe 
me: Closing org.springframework.conte 
jsr250-destory-method 
@Bean-destory-method 


图 2-3 ”运行 结果 


2.4 Profile 


2.4.1 点睛 


Profile 为 在 不 同 环境 下 使 用 不 同 的 配置 提供 了 
支持 (开发 环境 下 的 配置 和 生产 环境 下 的 配置 肯 
定 是 不 同 的 ， 例 如 ， 数 据 库 的 配置 ) 。 


(1) 通过 设 定 Environment 的 ActiveProfiles 来 
设 定 当前 context 需 要 使 用 的 配置 环境 。 在 开发 中 
使 用 @Profile 注 解 类 或 者 方法 ， 达 到 在 不 同情 况 下 
迁 返 实例 化 不 同 的 Bean 。 


(2) 通过 设 定 jvm 的 spring.profiles.active 参 数 


来 设置 配置 环境 。 


(3) Web 项 目 设置 在 Servlet 的 context 
parameter 中 。 


Servlet 2.5 及 以 下 : 


«servlet» 
<servlet-name>dispatcher</servlet-name> <servlet- 
class>org.springframework.web.servlet.DispatcherServlet</ser 


vlet-class> 
<init -param> 
<param-name>spring.profiles.active</param-name> 
<param-value>production</param-value> 
«/init-param» 
</servlet> 


Servlet 3.0 及 以 上 : 


public class WebInit implements WebApplicationInitializer { 
QOverride 
public void onStartup(ServletContext container) throws 
ServletException { 


container.setlInitParameter("spring.profiles.default", 


"dev" ) F 


j 


(1) 示例 Bean ° 
package com.wisely.highlight spring4.ch2.profile; 


public class DemoBean { 
private String content; 
public DemoBean(String content) { 
super(); 
this.content - content; 


j 


public String getContent() ( 


return content; 


j 


public void setContent(String content) { 
this.content - content; 
} 


(2) Profile 配 置 。 


package com.wisely.highlight spring4.ch2.profile; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 


QConfiguration 
public class ProfileConfig ( 
QBean 
QProfile("dev") //1 
public DemoBean devDemoBean() { 
return new DemoBean("from development profile"); 
} 


QBean 
QProfile("prod") //2 
public DemoBean prodDemoBean() { 
return new DemoBean("from production profile"); 
} 


代码 解释 
@Profile 为 dev 时 实例 化 devDemoBean ° 


@Profile 为 prod 时 实例 化 prodDemoBean 。 


(3) 运行 。 


package com.wisely.highlight spring4.ch2.profile; 
import 
org.springframework.context.annotation.AnnotationConfigAppli 
cationContext; 
public class Main ( 

public static void main(String[] args) ( 


AnnotationConfigApplicationContext context - 
new AnnotationConfigApplicationContext(); 


context.getEnvironment().setActiveProfiles("prod"); //1 
context.register(ProfileConfig.class);//2 
context.refresh(); //3 


DemoBean demoBean - 
context.getBean(DemoBean.class); 


System.out.println(demoBean.getContent()); 


context.close(); 


代码 解释 
(和 完 将 活动 的 Profile 设 置 为 prod ° 


后 置 注册 Bean 配 置 类 ， 不 然 会 报 Bean 末 定 
义 的 错误 。 


加 刷新 容器 。 


结果 如 图 2-4 所 示 。 


六 月 @9，2815 5:02:59 F+org.springframewo 
信息 : Refreshing org.springframework. conte 
from production profile 

六 月 969，2015 5:03:00 F+rorg.springframewo 


m2: Closing org.springframework.context 


图 2-4 ”运行 结 
将 context.getEnvironment 
() .setActiveProfiles (*prod") 修改 为 
context.getEnvironment () .setActiveProfiles 


("dev") ， 效 果 如 图 2-5 所 示 。 


六 月 89，2815 5:09:00 F+org.springframewor 
信息 : Refreshing org.springframework.conte; 
from development profile 

*A09, 2015 5:09:01 F+org.springframewor 
信息 : Closing org.springframework.context.| 


图 2-5 ”修改 的 效果 


2.5 事件 (Application Event) 


2.5.1 点睛 


Spring 的 事件 (Application Event) 为 Bean 与 
BeanZ.|R] E38 E bes T 文 持 。 当 一 个 Bean 处 
理 完 一 个 任务 之 后 ， 硕 望 另外 一 个 Bean 知 道 并 能 
做 相应 的 处 理 ， 这 时 我 们 束 需 要 让 另外 一 个 Bean 
监听 当前 Bean 所 发 送 的 事件 。 


Spring 的 事件 需要 遵循 如 下 流程 : 
(1) 目 定 义 事件 ， 集 成 ApplicationEvent ° 


(2) 定义 事件 监听 侨 ， 实 现 


ApplicationListener ° 


(3) 使 用 容 右 发 布 事件 。 


2.5.2 ”示例 


(1) 目 定义 事件 。 


package com.wisely.highlight spring4.ch2.event; 
import org.springframework.context.ApplicationEvent; 


public class DemoEvent extends ApplicationEvent{ 
private static final long serialVersionUID - 1L; 
private String msg; 


public DemoEvent(Object source,String msg) { 
super (source); 
this.msg = msg; 


j 


public String getMsg() 1 
return msg; 


j 


public void setMsg(String msg) 1 
this.msg - msg; 


j 


(2) REITEN ° 


package com.wisely.highlight_spring4.ch2.event; 


import org.springframework.context.ApplicationListener; 
import org.springframework.stereotype.Component; 


QComponent 
public class DemoListener implements 
ApplicationListener<DemoEvent> {//1 

public void onApplicationEvent(DemoEvent event) {//2 


String msg = event.getMsg(); 


System. out.printin("#%(bean-demoListener ) 接 收 到 了 


bean-demoPublisher 发 布 的 消息 :"+ msg); 


} 


代码 解释 


实现 ApplicationListener 接 口 ， 并 指定 监听 
的 事件 类 型 。 


(使 用 onApplicationEvent 方 法 对 消 忆 进行 接 
SENI o 


(3) 事件 发 布 类 。 


package com.wisely.highlight spring4.ch2.event; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.context.ApplicationContext; 
import org.springframework.stereotype.Component; 


QComponent 
public class DemoPublisher { 
QAutowired 
ApplicationContext applicationContext; //1 


public void publish(String msg) { 
applicationContext.publishEvent(new DemoEvent(this, 
msg)); //2 
J 


代码 解释 


注入 ApplicationContext 用 来 发 布 事 件 。 


DIE ApplicationContextH^JpublishEvent7; 7X 
来 发 布 。 


(4) 配置 类 。 


package com.wisely.highlight spring4.ch2.event; 


import 
org.springframework.context.annotation.ComponentScan; 
import 
org.springframework.context.annotation.Configuration; 


QConfiguration 
QComponentScan("com.wisely.highlight spring4.ch2.event") 
public class EventConfig { 


package com.wisely.highlight spring4.ch2.event; 


import 
org.springframework.context.annotation.AnnotationConfigAppl 
icationContext; 


public class Main ( 


public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(EventConfig.class); 


DemoPublisher demoPublisher - 
context.getBean(DemoPublisher.class); 


demoPublisher.publish("hello application event"); 


context.close(); 


结果 如 图 2-6 所 示 。 


7XH 99, 2015 5:54:09 FF org.springframework.context.annotation.AnnotationConfigA 
信息 : Refreshing org.springframework.context.annotation.AnnotationConfigApplicati 
我 (bean-demoListener) 接 收 到 了 bean-demoPublisher 发 布 的 消息 :hello application event 

六 月 869，2815 5:54:09 下 午 org.springframework.context.annotation.AnnotationConfigA 
信息 : Closing org.springframework.context.annotation.AnnotationConfigApplicationC 


2-6 ”运行 结 采 


第 3 章 Springm Ripe 
3.1 Spring Aware 


3.1.1 AH 


SpringB (ALTE BPO 3 re te UR AT AY 
Bean*; Spring Zt 88 HJ T£ TEE 1x8 X VAR © BI] 
DRUK Aaa E ROCA s, Google 
Guice， 这 时 Bean 之 间 的 耦合 度 很 低 。 


但 是 在 实际 项 目 中 ， 你 不 可 避免 时 要 用 到 
Spring as AF 的 功能 资源 ， 这 时 你 的 Bean 必 须 
要 意识 到 Spring 容器 的 存在 ， 才 能 调用 Spring 所 提 
供 的 资源 ， 这 就 古 所 谓 的 Spring Aware。 其 实 
Spring Aware 本 来 就 古 Spring 设 计 用 来 框架 内 部 使 
用 的 ， 奉 使 用 了 Spring Aware， 你 的 Bean 将 会 和 
SpringTE Z8 fS e 


Spring 提供 的 Aware 接 口 如 表 3-1 所 示 。 


表 3-1 Spring 提供 的 Aware 接 口 


BeanNameAware 获得 到 容器 中 Bean 的 名 称 

BeanFactory Aware 获得 当前 bean factory， 这 样 可 以 调用 容器 的 服务 

ApplicationContextAware* 当前 的 applica onte 可 以 调用 容器 的 服务 
iH 


ge source， 这 样 可 以 义 本 信息 


MessageSourceAware 获得 messa. ag 
Hil Rp 发 布 器 ， 可 以 发 布 事 n. 入 的 DemoPublisher 也 可 实现 这 个 接 | 
ApplicationEventPublisherAware 来 发 布 事件 
人 
ResourceLoaderAware KEAR 加 载 器 ， 可 以 获得 外 部 资源 文件 


Spring Aware 有 的 目的 是 为 了 让 Bean 获 得 Spring 
容 怖 的 服务 。 因 为 ApplicationContext 接 口 集 成 了 
MessageSourcef O ` ApplicationEventPublisher# 
口 和 ResourceLoader 接 口 ， 所 以 Bean 继 承 
ApplicationContextAware Hf 以 获得 Spring 容器 的 所 
有 上 服务， 但 原则 上 我 们 还 是 用 到 什么 接口 ， 驶 实 
现 什么 接口 。 


3.1.2 “示例 


(1) 准备 。 在 
com.wisely.highlight_ springd. ch3.aware 包 下 新 建 一 
个 test.txt， 内 容 随意 ， 给 下 面 的 外 部 资源 加 载 使 


用 o 
(2) Spring Aware 演 示 Bean ° 


package com.wisely.highlight_spring4.ch3.aware; 


import java.io.IOException; 


import org.apache.commons.io.IOUtils; 

import org.springframework.beans.factory.BeanNameAware; 
import org.springframework.context.ResourceLoaderAware; 
import org.springframework.core.io.Resource; 

import org.springframework.core.io.ResourceLoader; 
import org.springframework.stereotype.Service; 


QService 
public class AwareService implements 
BeanNameAware, ResourceLoaderAware{//1 


private String beanName; 
private ResourceLoader loader; 


QOverride 
public void setResourceLoader(ResourceLoader 
resourceLoader) (//2 
this.loader - resourceLoader; 


j 


@Override 

public void setBeanName(String name) {//3 
this.beanName = name; 

} 


public void outputResult(){ 
System.out.printlLln("Bean 的 名 称 为 : " + beanName); 


Resource resource = 


loader.getResource("classpath:com/wisely/highlight spring4/ 
ch2/aware/test.txt"); 


try{ 


System.out.printLn("ResourceLoader 加 载 的 文件 内 容 
为 : " + IOUtils.toString(resource.getInputStream())); 


jcatch(IOException e){ 
e.printStackTrace(); 


j 


代码 解释 


ODSCHBeanNameAware ^ 
ResourceLoaderAware 接 口 ， 获 得 Bean 名 称 和 资源 


加 载 的 服务 。 


) 实 现 ResourceLoaderAware 需 重 写 
setResourceLoader ° 


(3) 实 现 BeanNameAware 需 重 写 setBeanName 方 


(3) 配置 类 。 


package com.wisely.highlight_spring4.ch3.aware; 


import 
org.springframework.context.annotation.ComponentScan; 
import 
org.springframework.context.annotation.Configuration; 
QConfiguration 

QComponentScan("com.wisely.highlight spring4.ch3.aware") 
public class AwareConfig { 


package com.wisely.highlight spring4.ch3.aware; 


import 
org.springframework.context.annotation.AnnotationConfigAppl 
icationContext; 


public class Main { 
public static void main(String[] args) { 


AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(AwareConfig.class); 


AwareService awareService - 
context.getBean(AwareService.class); 
awareService.outputResult(); 


context.close(); 


结果 如 图 3-1 所 示 。 


AA 10, 2015 10:41:00 LF org.springframework 
信息 : Refreshing org.springframework. context. 
Bean pR: awareService 


ResourceLoaderhl# RZ FAA: 111111 
AA 10, 2015 10:41:00 LF org.springframework 
信息 : Closing org.springframework.context. ann 


32 ”多 线程 


Spring 通 过 任务 执行 器 (TaskExecutor) 来 实 
现 多 线程 和 并 发 编程 。 使 用 
ThreadPoolTaskExecutor 可 实现 一 个 基于 线程 池 的 
TaskExecutor。 而 实际 开发 中 任务 一 般 是 非 阻 碍 
的 ， 即 异步 时 ， 所 以 我 们 要 在 配置 类 中 通过 
@EnableAsync 开 局 对 异步 任务 的 文 持 ， 并 通过 在 
实际 执行 的 Bean 的 方法 中 使 用 @Async 注 解 来 声明 
HABE (EE © 


3.2.2 “示例 


(1) 配置 类 。 


package com.wisely.highlight spring4.ch3.taskexecutor; 
import java.util.concurrent.Executor; 
import 


org.springframework.aop.interceptor.AsyncUncaughtExceptionH 
andler; 


Import 
org.springframework.context.annotation.ComponentScan; 
import 
org.springframework.context.annotation.Configuration; 
import 
org.springframework.scheduling.annotation.AsyncConfigurer; 
import 
org.springframework.scheduling.annotation.EnableAsync; 
import 
org.springframework.scheduling.concurrent.ThreadPoolTaskExe 
cutor; 

QConfiguration 

QComponentScan("com.wisely.highlight spring4.ch3.taskexecut 
or") 

QEnableAsync //1 

public class TaskExecutorConfig implements 
AsyncConfigurer(//2 


QOverride 
public Executor getAsyncExecutor() {//2 
ThreadPoolTaskExecutor taskExecutor - new 
ThreadPoolTaskExecutor(); 

taskExecutor.setCorePoolSize(5); 
taskExecutor.setMaxPoolSize(10); 
taskExecutor.setQueueCapacity(25); 
taskExecutor.initialize(); 
return taskExecutor; 


j 


@Override 
public AsyncUncaughtExceptionHandler 
getAsyncUncaughtExceptionHandler() { 
return null; 


j 


代码 解释 
(DD 利用 @EnableAsync 注 解 开局 异步 任务 支 


持 。 


配置 类 实现 AsyncConfigurer 接 口 并 重 写 
getAsyncExecutor7; ik, Jf3klg]—^^ 
ThreadPoolTaskExecutor， 这 样 我 们 就 获得 了 一 个 
基于 线程 池 TaskExecutor ° 


(2) 任务 执行 类 。 


package com.wisely.highlight_spring4.ch3.taskexecutor; 


import org.springframework.scheduling.annotation.Async; 
import org.springframework.stereotype.Service; 

@Service 

public class AsyncTaskService { 


@Async //1 


public void executeAsyncTask(Integer i){ 
System.out.println(" 执 行 异步 任务 : "4i); 


QAsync 
public void executeAsyncTaskPlus(Integer i){ 
System.out.println(" 执 行 异步 任务 +1:; "+(i+1)); 


代码 解释 


(DD 通过 @Async 注 解 表 明 该 方法 是 个 异步 方 
法 ， 如 采 注 解 在 类 级 别 ， 则 表明 该 类 所 有 的 方法 
都 是 异步 方法 ， 而 这 里 的 方法 目 动 被 注入 使 用 
ThreadPoolTaskExecutorfE 7j TaskExecutor ° 


(3) 运行 。 


package com.wisely.highlight spring4.ch3.taskexecutor; 


import 
org.springframework.context.annotation.AnnotationConfigAppl 
icationContext; 


public class Main ( 


public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(TaskExecutorConfig. 
class); 


AsyncTaskService asyncTaskService - 
context.getBean(AsyncTaskService.class); 


for(int i =O ;i«10;i--)( 
asyncTaskService.executeAsyncTask(1i); 
asyncTaskService.executeAsyncTaskPlus(i); 


} 


context.close(); 


- 结 采 是 并 发 执行 而 不 是 顺序 执行 的 ， 如 图 3-2 
7e 


Drei: 3 
执行 异步 任务 +1: 4 
执行 异步 任务 : 4 
TERES: 5 
执行 异步 任务 : 5 
执行 于 步 任 务 +1: 6 
执行 于 步 任务 : 6 
执行 开 步 任务 +1: 7 
执行 异步 性 务 : 7 
执行 寞 步 性 务 +1: 8 
执行 异步 任务 : 8 
执行 异步 性 务 +1: 9 
HIRES: 9 
执行 于 步 任 务 +1: 10 
执行 异步 任务 : 0 
执行 异步 任务 : 1 


3-2 ”运行 结果 


3.3 ”计划 任务 


从 Spring 3.1 开 始 ， 计 划 任 务 在 Spring 中 的 实 
现 变 得 异常 的 众 单 。 首 移 通过 在 配置 类 注解 
@EnableScheduling 来 开局 对 计划 任务 的 文 择 ， 然 
后 在 要 执行 计划 任务 的 方法 上 注解 @Scheduled 
声明 这 是 一 个 计划 任务 。 


Spring 通 过 @Scheduled 文 持 多 种 类 型 的 计划 
EZ, cron ` fixDelay ^ fixRate 等 。 


3.3.2 “示例 


(1) 计划 任务 执行 类 。 


package com.wisely.highlight spring4.ch3.taskscheduler; 


import java.text.SimpleDateFormat; 
import java.util.Date; 


import org.springframework.scheduling.annotation.Scheduled; 
import org.springframework.stereotype.Service; 


QService 
public class ScheduledTaskService { 


private static final SimpleDateFormat dateFormat - new 
SimpleDateFormat ("HH:mm:ss"); 


QScheduled(fixedRate - 5000) //1 
public void reportCurrentTime() { 
System.out.println(" 每 隔 五 秒 执行 一 次 " + 
dateFormat.format(new Date())); 


QScheduled(cron = "0 2811? **" ) //2 
public void fixTimeExecution(){ 
System,out,.println(" 在 指定 时 间 " + 
dateFormat.format(new Date())+" 执 行 ")，; 
} 


代码 解释 


DD 通 过 @Scheduled 声 明 该 方法 是 计划 任务 ， 
使 用 fixedRate 属 性 每 隔 固定 时 间 执行 。 


) 使 用 cron 属 性 可 按照 指定 时 间 执 行 ， 本 例 指 
的 是 每 天 11 点 28 分 执行 ; cron 是 UNIX 和 类 UNIX 
(Linux) 系统 下 的 定时 任务 。 


(2) 配置 类 。 


package com.wisely.highlight spring4.ch3.taskscheduler; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
import 


org.springframework.scheduling.annotation.EnableScheduling; 


QConfiguration 

QComponentScan("com.wisely.highlight spring4.ch3.taskschedul 
er") 

QEnableScheduling //1 

public class TaskSchedulerConfig { 


Í 
代码 解释 


(通过 @EnableScheduling 注 解 开启 对 计划 任 
务 的 文 持 。 


package com.wisely.highlight spring4.ch3.taskscheduler; 


import 
org.springframework.context.annotation.AnnotationConfigAppli 
cationContext; 


public class Main ( 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 
AnnotationConfigApplicationContext(TaskSchedulerConfig.class 


); 
} 


} 


结果 如 图 3-3 所 示 。 


Sane sT—-X 11:27:57 
在 指定 时 间 11:28: 00th 77 

每 隔 五 机 执行 一 光 11:28:02 
每 隔 五 种 执行 一 次 11:28:07 
每 隔 五 种 执行 一 次 11:283:12 


每 隅 五 神 执 行 一 次 11:28:17 
每 隔 五 种 执行 一 次 11:28:22 
每 隅 五 视 执 行 一 灾 11:28:27 
每 隔 五 种 执行 一 次 11:28:32 
Sintii1—X 11:28:37 
SIS PPRUT—X 11:28: 


图 3-3 ”运行 结果 


3.4 Sita Conditional 


3.4.1 AIS 


在 2.4 广 学 到 ， 通 过 活动 的 profile， 我 们 可 以 
获得 不 同 的 Bean。Spring 4 提供 了 一 个 更 通用 的 基 
于 条 件 的 Bean 的 创建 ， 即 使 用 @Conditional 注 解 。 


@Conditional 根 据 满 足 某 一 个 特定 条 件 创建 一 
个 特定 的 Bean。 比 方 说 ， 当 某 一 个 jar 包 在 一 个 类 
路 径 下 的 时 候 ， 目 动 配置 一 个 或 多 个 Bean; 或 者 
只 有 某 个 Bean 被 创建 才 会 创建 另外 一 个 Bean。 总 
的 来 说 ， 融 是 根据 特定 条 件 来 控制 Bean 的 创建 行 
为 ， 这 样 我 们 可 以 利用 这 个 特性 进行 一 些 目 动 的 
配置 。 

人 在 Spring Boot 中 将 会 大 量 应 用 到 条 件 注解 ， 
更 多 内 容 见 本 书 6.17。 


下 面 的 示例 将 以 不 同 的 控 作 系统 作为 条 件 ， 
我 们 将 通过 实现 Condition 接 口 ， 并 重 写 其 matches 
方法 来 构造 判断 条 件 。 厂 在 Windows 系 统 下 运行 


程序 ， 则 输出 列表 命令 为 dir;， 知 在 Linux 损 作 系 统 
下 运行 程序 ， 则 输出 列表 命令 为 ls 。 


3.4.2 示例 


1. 判 断 条 件 定 义 
(1) 判定 Windows 的 条 件 。 


package com.wisely.highlight_spring4.ch3.conditional; 


import org.springframework.context.annotation.Condition; 
import 
org.springframework.context.annotation.ConditionContext; 
import org.springframework.core.type.AnnotatedTypeMetadata; 


public class WindowsCondition implements Condition { 


public boolean matches(ConditionContext context, 
AnnotatedTypeMetadata metadata) { 
return 
context.getEnvironment().getProperty("os.name").contains ("Wi 
ndows"); 


j 


(2) 判定 Linux 的 条 件 。 


package com.wisely.highlight_spring4.ch3.conditional; 


import org.springframework.context.annotation.Condition; 
import 
org.springframework.context.annotation.ConditionContext; 
import org.springframework.core.type.AnnotatedTypeMetadata; 


public class LinuxCondition implements Condition { 


public boolean matches(ConditionContext context, 
AnnotatedTypeMetadata metadata) { 


return 
context.getEnvironment().getProperty("os.name").contains("Li 
nux"); 
} 
} 


2. 不 同系 统 下 Bean 的 类 
(1) 接口 。 


package com.wisely.highlight_spring4.ch3.conditional; 
public interface ListService { 


public String showListCmd(); 
j 


(2) Windows 下 所 要 创建 的 Bean 的 类 » 


package com.wisely.highlight_spring4.ch3.conditional; 
public class WindowsListService implements ListService { 
QOverride 


public String showListCmd() { 
return "dir"; 


j 


(3) Linux 下 所 要 创建 的 Bean 的 类 。 


package com.wisely.highlight_spring4.ch3.conditional; 


public class LinuxListService implements ListService{ 


QOverride 

public String showListCmd() 1 
return "ls"; 

} 


3. 配 置 类 


package com.wisely.highlight spring4.chS3.conditional; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Conditional; 
import org.springframework.context.annotation.Configuration; 


QConfiguration 
public class ConditionConifg { 
QBean 
QConditional(WindowsCondition.class) //1 
public ListService windowsListService() { 
return new WindowsListService(); 
} 


QBean 

@Conditional(LinuxCondition.class) //2 

public ListService linuxListService() ( 
return new LinuxListService(); 

} 


代码 解释 


通过 @Conditional 注 解 ， 和 人 符合 Windows 条 件 
则 实例 化 windowsListService ° 


NEAN P ` TJ As CAT: 
GO) 通 过 @Conditional 注 解 ， 符 合 Linux 条 件 则 
Ro " A : 
实例 化 linuxListService ° 
NE A 
4.43211 
package com.wisely.highlight_spring4.ch3.conditional; 
import 
org.springframework.context.annotation.AnnotationConfigAppli 
cationContext; 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new 
AnnotationConfigApplicationContext(ConditionConifg.class); 
ListService listService - 


context.getBean(ListService.class); 


System.out.println(context.getEnvironment().getProperty("os. 


name" ) 
+ "系统 下 的 列表 命令 为 : " 
+ listService.showListCmd()); 
} 
} 


结果 如 图 3-4 和 图 3-5 所 示 。 


RA 10, 2015 3:21:45 FF org.spring 
信息 : Refreshing org.springframework 
Windows 8.I 系 统 下 的 列表 命令 为 : dir 


7XH 10, 2015 3:21:45 FF org.spring 
信息 : Closing org.springframework.cc 


图 3-4 ”Windows 下 列表 命令 


六 月 10, 2015 5:53:39 FF org.spring 
信息 : Refreshing org.springframewor 
Linux 系 统 下 的 列表 命令 为 : ls 


六 月 10, 2015 5:53:40 FF org.spring 
信息 : Closing org.springframework.cq 


图 3-5 ”Linux 下 列表 命令 


3.5 组 合 注解 与 元 注解 
3.5.1 点睛 


从 Spring 2 开始 ， 为 了 响应 JDK 1.5 推 出 的 注 
解 功能 ，Spring 开 始 大 量 加 入 注解 来 登 代 xml 配 
置 。Spring 的 注解 主要 用 来 配置 注入 Bean， 切 面 
相关 配置 (@Transactional) 。 随 着 注解 的 大 量 使 
用 ， 尤 其 相同 的 多 个 注解 用 到 各 个 类 中 ， 会 相当 
史明 。 这 束 症 所 请 的 模板 代码 ， 是 Spring 设 计 原 
则 中 要 消除 的 代码 。 


所 请 元 注解 其 实 就 是 可 以 注解 到 别 的 注解 上 
的 注解 ， 被 注解 的 注解 称 之 为 组 合 注解 、 是 可 能 
有 点 拓 口 ， 体 会 含义 最 重要 ) ， 组 合 注解 具备 元 
注解 的 功能 。Spring 的 很 多 注解 都 可 以 作为 元 注 
解 ， 而 且 Spring 本 号 已 经 有 很 多 组 合 注 解 ， 如 
(2 Configurations, zi — T 2H & (9 Component? t fF, 
表明 这 个 类 其 实 也 是 一 个 Bean ° 


我 们 前 面 的 草 广 里 大 量 使 用 @Configuration 和 
@ComponentScan 注 解 到 配置 类 上 ， 如 采 你 跟 看 本 


书 一 直 在 融 代 码 的 话 是 不 古 


ML, 
Ji, 


fS EA SU T 


呢 ? 下 面 我 将 这 两 个 元 注解 组 成 一 个 组 合 注解 
这 样 我 们 只 需 写 一 个 注解 就 可 以 表示 两 个 注解 。 


3.5.2 “示例 


(1) 示例 组 合 注解 。 


package com.wisely.highlight spring4.ch3.annotation; 


import java.lang.annotation.Documented; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation.Target; 


import 


org.springframework.context.annotation.ComponentScan; 


import 


org.springframework.context.annotation.Configuration; 


QTarget(ElementType.TYPE) 


QRetention(RetentionPolicy.RUNTIME) 


@Documented 
@Configuration //1 
@ComponentScan //2 


public @interface WiselyConfiguration { 


String[] value() default {}; //3 


代码 解释 


由 组合 @Configuration 元 注解 。 
组合 @ComponentScan 元 注解 。 
(348 xs value ZW ° 

(2) 演示 服务 Bean ° 


package com.wisely.highlight spring4.ch3.annotation; 
import org.springframework.stereotype.Service; 


QService 
public class DemoService ( 


public void outputResult(){ 
System,out.printLn(" 从 组 合 注解 配置 照样 获得 的 pean'" ) ) 


j 


(3) 新 的 配置 类 。 


package com.wisely.highlight spring4.ch3.annotation; 
QWiselyConfiguration("com.wisely.highlight spring4.ch3.anno 
tation")//1 

public class DemoConfig ( 


} 


代码 解释 


: 。 。 人 ya ` 
OEH owiselyConfiguration?H & T ft S: 
@Configuration#!]@ComponentScan ° 
ACE ue 
(4) 运行 。 
package com.wisely.highlight spring4.ch3.annotation; 
import 
org.springframework.context.annotation.AnnotationConfigAppl 
icationContext; 
public class Main ( 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new 


AnnotationConfigApplicationContext(DemoConfig.class); 


DemoService demoService - 
context.getBean(DemoService.class); 


demoService.outputResult(); 


context.close(); 


结果 如 图 3-6 所 示 。 


RA 10, 2015 6:41:30 FF org.sprin 
信息 : Refreshing org.springframewor 


从 组 人 注解 配 寺 照样 获得 的 bean 
RA 10, 2015 6:41:30 FF org.sprin 
信息 : Closing org.springframework. 4 


图 3-6 ”运行 结果 


3.6 @Enable*/+ FH) LVF Re 


在 本 章 的 第 一 部 分 我 们 通过 : 


@EnableAspectUJAutoProxy 开 局 对 AspectJ 目 动 
RERIT 


@EnableAsync 开 局 异步 方法 的 文 持 。 
@EnableScheduljing 开 局 计划 任务 的 文 持 。 
在 第 二 部 分 我 们 通过 : 


@EnableWebMvc 开 局 Web MVC 的 配置 文 
RF 


在 第 三 部 分 我 们 通过 : 


@EnableConfigurationProperties 开 局 对 
@ConfigurationProperties 注 解 配 置 Bean 的 文 持 。 


@EnableJpaRepositories 开 局 对 Spring Data 
JPA Repository 的 支持 。 


@OEnableTransactionManagement 开 局 注解 式 
事务 的 文 持 。 


@EnableCaching 开 局 注解 式 的 缓存 文 持 。 


通过 人 简单 的 @Enable* 来 开局 一 项 功能 的 支 
持 ， 从 而 避免 目 己 配置 大 量 的 代码 ， 大 大 降低 使 
用 难度 。 那 么 这 个 神奇 的 功能 的 实现 原理 是 什么 
WE? 我 们 一 起 来 研究 一 下 。 


通过 观察 这 些 @Enable* 注 解 的 源码 ， 我 们 发 
现 所 有 的 注解 都 有 一 个 @Import 注 骨 ，@Import 古 
用 来 导入 配置 类 的 ， 这 也 就 意味 着 这 些 目 动 开局 
的 实现 其 实 是 导入 了 一 些 目 动 配置 的 Bean。 这 些 
导入 的 配置 方式 主要 分 为 以 下 三 种 类 型 。 


3.6.1 第 一 类 : 直接 导入 配置 类 


QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
QImport(SchedulingConfiguration.class) 
@Documented 

public @interface EnableScheduling { 


Kt 


直接 导入 配置 类 SchedulingConfiguration , 
个 类 注解 了 @Configuration， 且 注册 了 一 个 


scheduledAnnotationProcessor 上 的 Bean， 源 人 码 如 下 : 


QConfiguration 
QRole(BeanDefinition.ROLE INFRASTRUCTURE) 
public class SchedulingConfiguration ( 


QBean(name = 
TaskManagementConfigUtils.SCHEDULED ANNOTATION PROCESSOR BE 
AN. NAME) 
QRole(BeanDefinition.ROLE INFRASTRUCTURE) 
public ScheduledAnnotationBeanPostProcessor 
scheduledAnnotationProcessor() { 
return new ScheduledAnnotationBeanPostProcessor(); 


i 


3.6.2 BOR: 依据 条 件 选 择 配 置 类 


QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
QDocumented 
QImport(AsyncConfigurationSelector.class) 
public Qinterface EnableAsync { 
Class<? extends Annotation» annotation() default 
Annotation.class; 
boolean proxyTargetClass() default false; 
AdviceMode mode() default AdviceMode.PROXY; 
int order() default Ordered.LOWEST PRECEDENCE; 


AsyncConfigurationSelector 通 过 条 件 来 选择 需 
要 导入 的 配置 类 ， AsyncConfigurationSelector 的 H 
接口 为 ImportSelector， 这 个 接口 需 重 写 


selectImports 方 法 ， 在 此 方法 内 进行 事先 条 件 判 
repr. ZziadviceModeZJPORXY, Ji [n] 
ProxyAsyncConfiguration 这 个 配置 类 ; Æ 
activeMode 为 ASPECTJ， 则 返回 
AspectJAsyncConfigurationÉi, & 2S, RIBAN P: 


public class AsyncConfigurationSelector extends 
AdviceModeImportSelector«EnableAsync» ( 


private static final String 
ASYNC EXECUTION ASPECT CONFIGURATION CLASS NAME - 


"org.springframework.scheduling.aspectj.AspectJAsyncConfigu 
ration"; 


@Override 
public String[] selectImports(AdviceMode adviceMode) { 
switch (adviceMode) { 
case PROXY: 
return new String[] { 
ProxyAsyncConfiguration.class.getName() }; 
case ASPECTJ: 
return new String[] { 
ASYNC EXECUTION ASPECT CONFIGURATION CLASS NAME }; 
default: 
return null; 


3.6.3 ”第 三 类: 动态 注册 Bean 


QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
@Documented 


QImport(AspectJAutoProxyRegistrar.class) 
public Qinterface EnableAspectJAutoProxy ( 
boolean proxyTargetClass() default false; 


j 


AspectJAutoProxyRegistrar ZI Y 
ImportBeanDefinitionRegistrarz L1, ImportBean 
DefinitionRegistrar 的 作用 是 在 运行 时 目 动 添加 
Bean 到 已 有 的 配置 类 ， 通 过 重 写 方 法 : 


registerBeanDefinitions(AnnotationMetadata 
importingClassMetadata, 
BeanDefinitionRegistry registry) 


其 中 ，AnnotationMetadata 参 数 用 来 获得 当前 
配置 类 上 的 注解 ，BeanDefinitionRegistry 参 数 用 来 
注册 Bean 2 源码 如 下 : 


class AspectJAutoProxyRegistrar implements 
ImportBeanDefinitionRegistrar { 
@Override 
public void registerBeanDefinitions( 
AnnotationMetadata importingClassMetadata, 
BeanDefinitionRegistry registry) { 


AopConfigUtils.registerAspectJAnnotationAutoProxyCreatorIfN 
ecessary(registry); 


AnnotationAttributes enableAJAutoProxy - 


AnnotationConfigUtils.attributesFor(importingClassMetadata, 
EnableAspectJAutoProxy.class); 

if 
(enableAJAutoProxy.getBoolean("proxyTargetClass")) ( 


AopConfigUtils.forceAutoProxyCreatorToUseClassProxying(regi 
stry); 


j 


3.7 测试 
3.7.1 点睛 


测试 是 开发 工作 中 不 可 缺少 的 部 分 。 单 元 测 
二 只 和 时 对 当前 开发 的 类 和 方法 进行 测试 ， 可 以 全 
单 通过 模拟 依赖 来 实现 ， 对 运行 环境 没有 依赖; 
但 是 仅 仪 进行 早 元 测试 古 不 够 的 ， 它 只 能 签证 当 
前 类 或 方法 能 否 正 闸 工作 ， 而 我 们 想 要 知道 系统 
的 各 个 部 分 组 合 在 一 起 是否 能 正常 工作 ， 这 吏 是 
集成 测试 存在 的 意义 。 


集成 测试 一 般 需 要 来 目 不 同 层 的 不 同 对 象 的 
交互， 如 数据 库 、 网 络 连 接 、IoC 容 希 等 。 其 实 我 
们 也 经 常 通 过 运行 程序 ， 然 后 通过 目 己 控 作 来 完 
成 类 似 于 集成 测试 的 流程 。 集 成 测试 为 我 们 提供 
了 一 种 无 须 部 署 或 运行 程序 来 完成 验证 系统 各 部 
分 古 否 能 正常 协同 工作 的 能 力 。 

Spring 通过 Spring TestContex Framework 对 集 


成 测试 提供 顶级 文 持 。 它 不 依赖 于 特定 的 测试 框 
架 ， 既 可 使 用 Junit， 也 可 使 用 TestNG 。 


基于 Maven 构 建 的 项 目 结构 默认 有 天 于 测试 
的 目录 : src/test/java (测试 代码 ) ` 
src/test/resources (测试 资源 ) ， 区 别 于 
src/main/java (项 目 源 码 ) * src/main/resources 


(项 目 资 源 ) 。 


Spring 提 供 了 一 个 SpringJUnit4ClassRunner 
R, = T Spring TestContext Framework) 
能 。 过 @ContextConfiguration 来 本 置 Application 
iae, 通过 @ActiveProfiles 确 定 活动 的 profile 。 


在 使 用 了 Spring 测 斌 后， 我 们 前 面 的 例子 
的 “运行 ”部 分 都 可 以 用 Spring 测 试 来 检验 功能 能 否 
正常 运作 。 

集成 测试 涉及 程序 中 的 各 个 分 层 ， 本 市 只 对 
fa} RO ELE Application Context 和 在 测 试 中 注入 
Bean 做 演示 ， 在 本 书 第 二 部 分 和 第 三 部 分 会 对 
Spring 测试 做 更 多 的 讲述 o 


3.7.2 “示例 


1. 准 备 
增加 Spring 测试 的 依 顿 包 到 Maven: 


<!-- Spring test 支持 --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-test</artifactId> 
<version>${spring-framework.version}</version> 

</dependency> 

<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>4.11</version> 

</dependency> 


2. 业 务 代码 
在 src/main/java 下 的 源码 : 


package com.wisely.highlight spring4.ch3.fortest; 


public class TestBean { 
private String content; 


public TestBean(String content) { 
super(); 
this.content - content; 


i 


public String getContent() (1 
return content; 


j 


public void setContent(String content) { 
this.content - content; 


J 


3. 


在 src/main/java 下 的 源码 : 


package com.wisely.highlight spring4.ch3.fortest; 


import org.springframework.context.annotation.Bean; 
import 
org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 
QConfiguration 
public class TestConfig ( 

QBean 

QProfile("dev") 

public TestBean devTestBean() ( 

return new TestBean("from development profile"); 
} 


QBean 
QProfile("prod") 
public TestBean prodTestBean() { 
return new TestBean("from production profile"); 


j 


4. 测 试 
在 src/test/java 下 的 源码 : 


package com.wisely.highlight spring4.ch3.fortest; 


import org.junit.Assert; 

import org.junit.Test; 

import org.junit.runner.RunWith; 

import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.test.context.ActiveProfiles; 
import 
org.springframework.test.context.ContextConfiguration; 
import 


org.springframework.test.context.junit4.SpringJUnit4ClassRu 
nner; 


QRunwith(SpringJUnit4ClassRunner.class) //1 
@ContextConfiguration(classes = {TestConfig.class}) //2 
@ActiveProfiles("prod") //3 
public class DemoBeanIntegrationTests { 

QAutowired //4 

private TestBean testBean; 


QTest //5 
public void prodBeanShouldInject(){ 
String expected - "from production profile"; 


String actual - testBean.getContent(); 
Assert.assertEquals(expected, actual); 


j 


代码 解释 


@SpringJUnit4ClassRunner 在 JUnit 环 境 下 提供 
Spring TestContext Framework 上 的 功能 。 


@@ContextConfiguration H 2E JI se fio E. 
ApplicationContext， 其 中 classes 属 性 用 来 加 载 配 
AR ° 


@ @ActiveProfiles H X HHT& 5B profile ° 
(4) Ay fi FH 3f 3E HJ (D Autowired?t A Bean ? 


G) 测 试 代码 ， 通 过 JUnit 的 Assert 来 校 验 结果 
是 否 和 预期 一 致 。 


结 示 如 图 3-7 所 示 。 


属 Spring Explorer gju JUnit 33 


a” BE| QB 
Finished after 0.284 seconds 


Runs: 1/ B Errors: CH Failures: ( CES 


TL 
+r 


Ei com.wisely.highlight spri = Failure Trace 


3-7 测试 结果 


将 @ActiveProfiles (*prod") 改 为 


@ActiveProfiles (“dev”) ， 演 示 测 试 不 能 ; 
情景 ， 如 图 3-8 所 示 。 


通过 的 


4 


AR Spring Explorer gv JUnit 35 | = 


Finished after 0.327 seconds 


Runs: 1/ B Errors: CH Failures: * SSS 


v ic] com.wisely.highlight spri = Failure Trace 
EE] prodBeanShouldInje org.junit.ComparisonFailure: 
at com.wisely.highlight spri 


at org.springframework.tes 


图 3-8 演示 测试 不 能 通过 的 情景 


第 二 部 分 “点 睛 Spring MVC 4.x 


AE Spring MVC 基 础 


也 许 你 还 在 问 为 什么 要 用 Spring MVC, Struts 
2.X 不 才 是 主流 吗 ? 看 SSH 的 概念 多 火 ! 其 实 很 多 
A^ HEB F— MBAR, SSH EAE Struts 
1.x+Spring+Hibernate， 这 个 概念 已 经 有 十 几 年 的 
历史 了 。 在 Struts 1.x 的 时 代 ，Struts 1.x ZC 
惕 的 MVC 框 染 的 霸主 ， 但 是 在 新 的 MVC 框 架 涌 现 
的 时 代 ， 形 式 已 经 完全 不 是 这 样 的 了 ，Struts 2.x 
(EE T Struts 1.x 的 好 名 声 ， 让 国内 开发 者 认为 
Struts 2.x 是 霸主 继任 者 (其 实 两 者 在 技术 上 无 任 
RA) ， 导 致 国内 程序 员 大 多 数学 习 基 于 Struts 
2.x 的 框架 ， 叉 一 个 貌似 很 火 的 概念 出 来 了 S2SH 

(Struts 2.x+Spring+Hibernate) 整合 开发 。 


一 起 看 看 世界 范围 内 到 展 和 是 什么 状 讽 吧 ， 请 
看 下 面 的 调查 统计 。 


Zeroturnaround (知名 热 部 署 软件 JRebelj 
ral) 统计 如 图 4-1 所 示 。 


Web frameworks in use ` 


图 4-1 JRbel 厂 商 统计 
从 图 4-1 可 以 看 出 ，Spring MVC 的 市 场 占 有 率 
是 40%， 而 Struts 2 只 有 可 怜 的 6%， 况 然 只 比 骨 灰 
级 的 Struts 1 高 那么 一 点 点 。 


vitalflux.com 对 2014 2015 年 度 10 佳 Web 框 架 
排名 。 


前 10 名 没有 Struts 2 的 身影 ， 前 五 名 为 : 


1.Spring MVC 

2.Grails 

3.Play 

4.Spring Boot 

5. Vaadin 

说 了 这 人 么 多 ， 不 过 是 为 了 大 家 更 有 信心 地 学 


习 Spring MVC, Spring MVCÆ H Hif Java Web 杠 架 
当之无愧 的 霸主 。 


4.1 Spring MVC 概 壕 


说 到 Spring MVC， 不 得 不 先 来 谈 谈 什 么 是 
MVC， 它 和 三 层 架 构 是 什么 天 系 。 可 能 很 多 读者 
都 会 抢答 : 


MVC: Model+View+Controller (数据 模型 
+ 视图 + 控制 器 ) e 


— EUH: Presentation tier+Application 


tier-Data tier RIZ - Nr HH XS IRR) 。 


那 MVC 和 三 层 架 构 有 什么 天 系 呢 ? 在 我 面试 
程序 员 的 时 候 ， 经 第 会 有 面试 着 告诉 我 MVC 的 
Mite Ba AVE > Vibe REVUE > Cite 
jz o BAF? Whee Bk Aes? 


但 是 实际 上 MVC 只 存在 三 层 架 构 的 展现 层 ， 
M 实 际 上 是 数据 模型 ， 是 包含 数据 的 对 象 。 在 
Spring MVC 里 ， 有 一 个 专门 的 类 叫 Model， 用 来 
和 V 之 间 的 数据 交互 、 传 但; V 指 的 是 视图 页 面 ， 
& 5 JSP ` freeMarker ` Velocity ` Thymeleaf ` Tile 


等 ，C 当 然 就 是 控制 器 (Spring MVC 的 注解 
@Controller 的 类 ) 。 


在 本 书 我 很 把 茹 地 告诉 大 家 ， 本 书 将 不 会 介 
绍 太 多 View 层 的 知识 ， 只 会 简单 地 使 用 JSP 和 jstl 
作为 演示 ， 因 为 Spring MVC 支 持 的 模板 引擎 太 多 
了 ， 我 们 会 在 7.1 太 专门 介绍 Spring Boot 推 存 使 用 
的 模板 引擎 ， 本 章 关 注 Spring MVC 在 实际 开发 中 
的 各 种 配置 。 


而 三 层 架 构 是 整个 应 用 的 架构 ， 是 由 Spring 
FT bi BEA o — AE at) + BA Service 
` DAO 层 ， 这 两 个 反馈 在 应 用 层 和 数据 访问 


Nl Pull TE 


弄 消 MVC 和 三 层 染 构 的 天 系 对 我 们 理解 
Spring MVC 和 进行 Web 开 发 至 天 重要 。 


Spring MVC 使 我 们 可 以 简单 地 开发 灵活 且 松 
耘 合 的 web 项 目 ， 本 章 我 们 将 关注 与 基于 注解 和 
prem (无 xml 配 置 ) 的 Spring MVC 开 


4.2 Spring MVC 项 目 快 速 搭建 
4.2.1 点睛 


Spring MVC 提 供 了 一 个 DispatcherServlet 来 开 
发 Web 应 用 。 在 Servlet 2.5 及 以 下 的 时 候 只 要 在 
Web.xml 下 配置 <servlet> 元 素 即 可 。 但 我 们 在 本 证 
将 使 用 Servlet 3.0+ 无 web.xml 的 配置 方式 ， 在 
Spring MVC 里 实现 WebApplicationInitializer 接 口 便 
可 实现 等 同 于 web.xml 的 配置 。 


下 面 我 们 将 基于 Maven 挫 建 雯 配置 的 Spring 
MVC 原 型 项 目 ， 开 发 工具 相关 的 内 容 这 里 将 不 再 
je A ° 
4.2.2 “示例 


1. 构 建 Maven 项 目 


pom.xml 内 容 : 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-z'http://www.w3.0rg/2001/XMLSchema- instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.wisely</groupId> 
<artifactId>highlight_springmvc4</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>war</packaging> 


<properties> 
<!-- Generic properties --> 
<java.version>1.7</java.version> 
<project .build.sourceEncoding>UTF- 
8</project .build.sourceEncoding> 
<project.reporting. outputEncoding>UTF- 
8«/project.reporting.outputEncoding» 
<!-- Web --> 
<jsp.version>2.2</jsp.version> 
<jstl.version>1.2</jstl.version> 
<servlet.version>3.1.0</servlet.version> 
<!-- Spring --> 
<spring-framework.version>4.1.5.RELEASE</spring- 
framework.version> 
<!-- Logging --> 
<logback.version>1.0.13</logback.version> 
«slf4j.version»1.7.5«/slf4j.version» 
«/properties» 


«dependencies» 
<dependency> 
«groupId»javax«/groupId» 
<artifactId>javaee-web-api</artifactId> 
<version>7.0</version> 
<scope>provided</scope> 
</dependency> 


<!-- Spring MVC --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-webmvc</artifactId> 
<version>${spring-framework.version}</version> 

</dependency> 


<!-- 其 他 web 依 赖 - -> 


<dependency> 
«groupId»javax.servlet«/groupId» 
<artifactId>jstl</artifactId> 
<version>${jstl.version}</version> 

</dependency> 

<dependency> 
«groupId»javax.servlet«/groupId» 
<artifactId>javax.servlet-api</artifactId> 
<version>${servlet.version}</version> 
<scope>provided</scope> 

</dependency> 

<dependency> 
«groupId»javax.servlet.jsp«/groupId» 
<artifactId>jsp-api</artifactId> 
<version>${jsp.version}</version> 
<scope>provided</scope> 

</dependency> 


<!-- Spring and Transactions --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-tx</artifactId> 
<version>${spring-framework.version}</version> 

</dependency> 


«1-- 使 用 SLF4J 和 LogBack 作 为 日 志 --> 

<dependency> 
<groupId>org.slf4j</groupId> 
<artifactId>slf4j-api</artifactId> 
<version>${slf4j.version}</version> 

</dependency> 

<dependency> 
«groupId»10g4j«/groupId-» 
<artifactId>log4j</artifactId> 
<version>1.2.16</version> 

</dependency> 

<dependency> 
«groupId»org.slf4j«/groupId-» 
<artifactId>jcl-over-slf4j</artifactId> 
<version>${slf4j.version}</version> 

</dependency> 

<dependency> 
«groupId»ch.qos.logback«/groupId» 
<artifactId>logback-classic</artifactId> 
<version>${logback.version}</version> 


</dependency> 

<dependency> 
«groupId»ch.qos.logback«/groupId» 
<artifactId>logback-core</artifactId> 
<version>${logback.version}</version> 

</dependency> 

<dependency> 
«groupId»ch.qos.logback«/groupId» 
<artifactId>logback-access</artifactId> 
<version>${logback.version}</version> 

</dependency> 

</dependencies> 


<build> 
<plugins> 
<plugin> 
«groupId»org.apache.maven.plugins«c/groupId-» 
<artifactId>maven-compiler - 
plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>${java.version}</source> 
<target>${java.version}</target> 
</configuration> 
</plugin> 
<plugin> 
«groupId»org.apache.maven.plugins«c/groupId» 
«artifactId»maven-war-pluginc/artifactId» 
<version>2.3</version> 
<configuration> 


«failonMissingWebXml»false«/failOnMissingWebXml» 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


2. Eo mee 


fEsrc/main/resources H 3€ F, #1logback.xml 
用 来 配置 日 志 ， 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<configuration scan="true" scanPeriod="1 seconds"> 
<contextListener 
class="ch.qos.logback.classic.jul.LevelChangePropagator"> 
<resetJUL>true</resetJUL> 
</contextListener> 


<jmxConfigurator/> 
<appender name="console" 
class="ch.qos.logback.core.ConsoleAppender'"> 
<encoder> 
<pattern>logbak: %d{HH:mm:ss.SSS} %logger{36} - 
*ymsg%n</pattern> 
</encoder> 
</appender> 
«logger name="org.springframework.web" level="DEBUG"/> 
€le= 1 => 
«root level="info"> 
<appender-ref ref="console"/> 
</root> 
</configuration> 


代码 解释 


(1) 将 org.springframework.web 包 下 的 类 的 日 志 
级 别 设置 为 DEBUG， 我 们 开发 Spring MVC% H 
现 和 参数 类 型 相关 的 4XX 错 误 ， 设 置 此 项 我 们 会 
看 到 更 详细 的 错误 信息 。 


3.JH AR UL 


TEsrc/main/resources F #£\7viewsH se, Jf4E 
IL Ase P3mrEindexjsp, AZW TF: 


<%@ page language-"java" contentType="text/html; 
charset=UTF-8" 


pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
«html» 
«head» 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>Insert title here</title> 
</head> 
<body> 

<pre> 

Welcome to Spring MVC world 

</pre> 
</body> 
</html> 


代码 解释 


此 处 也 许 读 着 会 奇怪 ， 为 什么 页 面 不 放 和 在 
Maven 标 准 的 src/main/webapp/WEB-INF 下 ， 此 处 
这 样 建 的 主要 目的 是 让 大 家 熟悉 Spring Boot 的 页 
面 习 惯 的 放置 方式 ，Spring Boot 的 页 面 就 放置 在 


src/main/resources F ° 


4.Spring MVC 配 置 


package com.wisely.highlight springmvc4; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


QConfiguration 
QEnablewebMvc 
QComponentScan("com.wisely.highlight springmvc4") 
public class MyMvcConfig{ 

QBean 

public InternalResourceViewResolver viewResolver(){ 


InternalResourceViewResolver viewResolver = new 
InternalResourceViewResolver(); 

viewResolver.setPrefix("/WEB-INF/classes/views/"); 

viewResolver.setSuffix(".jsp"); 

viewResolver.setViewClass(JstlView.class); 

return viewResolver; 


j 


代码 解释 


此 处 无 任何 特别 ， 只 是 一 个 普通 的 Spring 配 置 
类 。 这 里 我 们 配置 了 一 个 JSP 的 ViewResolver， 用 
AERE ER EASE HUA i, dr, 
@EnablewWebMvc 注 解 会 开局 一 些 默认 配置 ， 如 一 


些 ViewResolver 或 者 MessageConverter 等 。 


在 此 处 要 特别 解释 一 下 Spring MVC 的 
ViewResolver， 这 是 Spring MVC 视 图 (JSP FHE 
html) 深 染 的 核心 机 制 ， Spring MVC 里 有 一 个 接 
口 叫做 ViewResolver (我 们 的 ViewResolver 都 实现 
该 接口 ) ， 实 现 这 个 接口 要 重 写 方法 
resolveViewName () ， 这 个 方法 的 返回 值 是 接口 
View, MI ViewH Anz size 1 FH] model ` request ` 
response 对 象 ， 并 将 泻 染 的 视图 (不 一 定 是 html， 
可 能 是 json、xml、pdf) RERNI aS ° 74.5.2 77 
我 们 会 介绍 更 多 天 于 ViewResolver 的 内 容 。 


可 能 读者 对 路 径 前 级 配置 为 /WEB- 
INF/classes/views/ 有 些 奇 惨 ， 怎 么 和 我 开发 的 目 永 
不 一 致 ? 因为 看 到 的 页 面 殖 末 是 运行 时 而 不 是 开 
发 时 的 代码 ， 运 行 时 代码 会 将 我 们 的 页 面目 动 编 
译 到 /WEB-INF/classes/views/ 下 ， 图 4-2 是 运行 时 的 
ASR Zak), OME CREEL BARA IT A E Bat 
FE, Spring Boot 中 ， 我 们 将 使 用 Thymeleaf 作 为 
模板 ， 因 而 不 需要 这 样 的 配置 。 


wtpwebapps » highlight springmvc4 » WEB-INF » classes » views 


名 称 修改 日 期 


index.jsp 


图 4-2 ”运行 时 的 目录 结构 
5.Web 配 置 


package com.wisely.highlight springmvc4; 


import javax.servlet.ServletContext; 
import javax.servlet.ServletException; 
import javax.servlet.ServletRegistration.Dynamic; 


import org.springframework.web.WebApplicationInitializer; 
import 
org.springframework.web.context.support.AnnotationConfigWebA 
pplicationContext; 

import org.springframework.web.servlet.DispatcherServlet; 


public class WebInitializer implements 
WebApplicationInitializer {//1 


QOverride 
public void onStartup(ServletContext servletContext) 
throws ServletException { 
AnnotationConfigwebApplicationContext ctx = new 
AnnotationConfigWebApplicationContext(); 
ctx.register(MyMvcConfig.class); 
ctx.setServletContext(servletContext); //2 


Dynamic servlet - 
servletContext.addServlet("dispatcher", new 
DispatcherServlet(ctx)); //3 

servlet.addMapping("/"); 

servlet.setLoadOnStartup(1); 


代码 解释 


(WebA pplicationlnitializerzé Spring? HE Hj HK 
配置 Servlet 3.0- C Eze, MEM p ERIS 
web.xml 的 位 置 。 实 现 此 接口 将 会 目 动 被 
SpringServletContainerInitializer (用 来 启动 Servlet 
3.0 容 器 ) 获取 到 。 


(新 建 WebApplicationContext， 注 册 配 置 类 ， 
并 将 其 和 当前 servletContext 天 联 。 


(3) 注 册 Spring MVC 的 DispatcherServlet ° 


6.18] EE Ta HAN 


package com.wisely.highlight springmvc4.web; 

import org.springframework.stereotype.Controller; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.ResponseBody; 


@Controller//1 
public class HelloController { 


QRequestMapping("/index")//2 
public String hello(){ 


return "index"; //3 


代码 解释 
利用 @Controller 广 解 声 明 是 一 个 控制 大 


(利用 @RequestMapping 配 置 URL 和 方法 之 间 
的 映射 。 


(9) 通 过 上 面 ViewResolver 的 Bean 配 置 ， 返 回 值 
为 index， 膏 明 我 们 的 页 面 放置 的 路 径 为 /WEB- 
INF/classes/views/index.jsp ° 

7. 运 行 


将 程序 部 署 到 Tomcat 中 ， 局 动 Tomcat， 并 访 
|H]http://localhost: 


8080/highlight_springmvc4/index， 如 图 4-3 所 示 。 


-O AO localhost 
图 手机 收藏 夫 history M9 GIS Œ ur E3HardWa Œ Resource Solution Œ Tools 


Welcome to Spring MVC world 


Al4-3 ”将 程序 部 署 到 Tomcat 


43 Spring MVC 的 利用 注解 
4.3.1 点睛 


Spring MVC 第 用 以 下 几 个 注解 。 
(1) @Controller 


@Controller 注 解 在 类 上 上， 表明 这 个 类 是 Spring 
MVC 里 的 Controller， 将 其 声明 为 Spring 的 一 个 
Bean, Dispatcher Servlet 会 目 动 扫 朱 注解 了 此 注解 
的 类 (这 里 和 我 们 在 1.3.3 亡 演示 用 注解 作为 拦截 
方式 的 例子 原理 类 似 ) ， 并 将 Web 请 求 映 射 到 注 
解 了 @RequestMapping 的 方法 上 。 这 里 特别 指 
出 ， 在 声明 普通 Bean 的 时 候 ， 使 用 @Component 、 
@Service、@Repository 和 @Controller 是 等 同 的 ， 
为 @Service、@Repository、@Controller 都 组 合 
了 @Compoment 元 注解 ， 但 在 Spring MVCF AAT 
rill asBeanHJAY fe, H BeH @Controller ° 


(2) @RequestMapping 


@RequestMapping 注 解 是 用 来 映射 Web 请 求 
(访问 路 径 和 参数 ) 、 处 理 类 和 方法 的 。 
@RequestMapping 可 注解 在 类 或 方法 上 。 注 解 在 
方法 上 的 @RequestMapping 路 径 会 继承 注解 在 类 
上 的 路 径 ，@RequestMapping 文 持 Servlet 的 request 
和 response 作 为 参数 ， 也 文 持 对 request 和 response 
的 媒体 类 型 进行 配置 。 


(3) (QResponseBody 
@ResponseBody X: FX [RB Eresponsef: 
内 ， 而 不 是 返回 一 个 页 面 。 我 们 在 很 多 基于 Ajax 


的 程序 的 时 候 ， 可 以 以 此 注解 返回 数据 而 不 是 页 
B. UCR) BCE RM Ba TIA LE 。 


(4) @RequestBody 


@RequestBody 人 允许 request 的 参数 在 request 体 
中 ， 而 不 是 在 直接 链接 在 地 址 后 面 。 此 广 解 放置 


(5) @PathVariable 


@PathVariable 用 来 接收 路 径 参 数 ， 
如 /news/001， 可 接收 001 作 为 参数 ， 此 注解 放置 在 


(6) @RestController 


(QRestControllerzé — 2H G1ERE, ZAG T 
@Controller 和 @ResponseBody， 这 就 意味 着 当 你 
只 开发 一 个 和 页 面 交 互 数 据 的 控制 的 时 候 ， 需 要 
使 用 此 注解 。 阁 没有 此 注解 ， 要 想 实 现 上 述 功 
能 ， 则 需 目 己 在 代码 中 加 @Controller 和 
@ResponseBody 两 个 注解 。 


下 面 的 示例 将 演示 这 几 个 注解 的 使 用 。 


4.3.2 示例 


1. 传 值 类 


添加 jackson 及 相关 依赖 ， 获 得 对 象 和 json 或 
xml 之 间 的 转换 : 


<1-- 对 json 和 xml 格 式 的 支持 - -> 
<dependency> 


<groupId>com.fasterxml.jackson.dataformat</groupId> 
<artifactId>jackson-dataformat -xml</artifactId> 
<version>2.5.3</version> 
</dependency> 


这 里 特别 指出 ， 在 实际 项 目 中 ， 我 们 其 实 主 
要 支持 json 数 据 ， 没 必要 同时 文 持 json 和 xml， 


为 json 比 xml 更 售 洁 。 由 于 JavaScript 的 广泛 使 用 ， 
json 成 为 最 推 存 的 格式 ， 在 这 种 情况 下 ， 我 们 的 依 
赖 包 如 下 (上 面 的 依赖 包含 下 面 的 依赖 ) 


<dependency> 
<groupId>com.fasterxml.jackson.core</groupId> 
<artifactId>jackson-databind</artifactId> 
<version>2.5.3</version> 

</dependency> 


此 类 用 来 演示 获取 request 对 象 参 数 和 返回 此 
对 象 到 response: 


package com.wisely.highlight springmvc4.domain; 


public class DemoObj { 
private Long id; 
private String name; 


public DemoObj() ( //1 
super(); 


} 

public Demoobj(Long id, String name) { 
super (); 
this.id = id; 
this.name = name; 


} 
public Long getId() { 
return id; 


public void setId(Long id) { 
this.id - id; 

} 

public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


代码 解释 
@jackson 对 对 象 和 json 做 转换 时 一 定 需 要 此 空 


构造 
2. 注 解 滥 示 控制 如 


package com.wisely.highlight springmvc4.web.ch4 3; 
import javax.servlet.http.HttpServletRequest; 


import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.PathVariable; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.ResponseBody; 


import com.wisely.highlight springmvc4.domain.DemoObj; 


@Controller // 1 
QRequestMapping("/anno") //2 
public class DemoAnnoController { 


@RequestMapping(produces = "text/plain;charset-UTF-8") 
// 3 
public @ResponseBody String index(HttpServletRequest 
request) { // 4 
return "url:" + request.getRequestURL() + " can 
access"; 


@RequestMapping(value = "/pathvar/{str}", produces = 
"text/plain; charset=UTF-8")// 5 
public @ResponseBody String demoPathVar (@PathVariable 
String str, 
HttpServletRequest request) { 
return "url:" + request.getRequestURL() + " can 


access,str: " + str; 


j 


QRequestMapping(value - "/requestParam", produces - 
"text/plain;charset-UTF-8") //6 
public QResponseBody String passRequestParam(Long id, 
HttpServletRequest request) ( 


return "url:" + request.getRequestURL() + " can 
access,id: " + id; 


j 


QRequestMapping(value - "/obj", produces - 
"application/json;charset=UTF-8")//7 

@ResponseBody //8 

public String passObj(DemoObj obj, HttpServletRequest 
request) { 


return "url:" + request.getRequestURL( ) 
+ " can access, obj id: " + 
obj.getId()+" obj name:" + obj.getName(); 


j 


@RequestMapping(value = { "/namei", "/name2" }, produces 
= "text/plain; charset=UTF-8")//9 

public @ResponseBody String remove(HttpServletRequest 
request) { 


return "url:" + request.getRequestURL() + " can 
access"; 


} 


代码 解释 


Q (Controller? f8 P: HER Zi — THE as ° 


@@RequestMapping (“/anno”) EIERS 
访问 路 径 是 /anno。 


(3) 此 方法 未 标注 路 人 径 ， 因 此 使 用 类 级 别 的 路 
径 /anno; produces 可 定制 返回 的 response 的 媒体 类 
型 和 字符 集 ， 或 需 返 回 值 是 json 对 象 ， 则 设置 


一 66 


produces=“application/json; charset=UTF-8”， 在 后 
面 的 革 市 我 们 会 闭 示 此 项 特性 。 


出 演示 可 接受 HttpServletRequest 作 为 参数 ， 当 
然 也 可 以 接受 HttpServletReponse 作 为 参数 。 此 处 
Hyg ReponseBody H X EMA Bii IB] ° 


COTRCINBESCER HE 306 TET UB RU PET 
@PathVariable 使 用 ， 访 问 路 径 


为 /anno/pathvar/xx° 


(8) 演示 常规 的 request 参 数 获取 ， 访 问 路 径 


为 /anno/requestParam? id-1 ° 


(0 演示 解释 参数 到 对 象 ， 访 问 路 径 
为 /anno/obj? id=1&name=xx ° 


@ReponseBody 也 可 以 用 在 方法 上 。 
YEAR BRA AN A] Ba EI AER TE, Ui TA] 


路 径 为 /annomame1 或 /annomame2 ° 


3.@RestController}#75 


package com.wisely.highlight_springmvc4.web.ch4_3; 


import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.highlight springmvc4.domain.DemoObj; 


QRestController //1 
QRequestMapping("/rest") 
public class DemoRestController { 


QRequestMapping(value - "/getjson",produces- 
{"application/json;charset=UTF-8"}) //2 
public DemoObj getjson (DemoObj obj)( 
return new DemoObj(obj.getId()-41, 
obj.getName()+"yy");//3 
} 
@RequestMapping(value = "/getxml",produces- 
{"application/xml;charset=UTF-8"})//4 
public DemoObj getxml(DemoObj obj) { 
return new DemoObj(obj.getId()+1, 
obj.getName()+"yy");//5 
} 


代码 解释 


(DD 使 用 @RestController， 声 明 是 控制 絮 ， 并 且 
返回 数据 时 不 需要 @ResponseBody。 


返回 数据 的 媒体 类 型 为 json。 
( 引 直 接 返 回 对 象 ， 对 和 象 会 目 动 转换 成 json 。 


(4 返回 数据 的 媒体 类 型 为 xml 。 
直接 返 回 对 象 ， 对 象 会 目 动 转换 为 xml。 
结果 如 图 4-4 和 图 4-5 所 示 。 


€ C | D localhost:8080/highlight springm 


mvc4/rest/getjson?id- 1&name-xx 


name: "xxyy 


Kj4a-4 访问 http:Wlocalhost: 
8080/highlight springmvc4A/rest/getjson? id=1&name=xx 


e ] localhost:8080/highlight springmvc4/rest/getxml?id- 1 &name-»o 


This XML file does not appear to have any style information associated with it. 
document tree is shown below. 


v XDenoObj xnlns-""» 
<id>2</id> 


<name>uxyy< name> 
</Demo0bj> 


图 4-5 ”访问 http:Wlocalhost: 
8080/highlight_springmvc4/rest/getxml’ id-1&name-xx 


4.4 Spring MVC 基 本 配置 


Spring MVC 的 定制 配置 需要 我 们 的 配置 类 继 
承 一 个 WebMvcConfigurerAdapter 类 ， 并 在 此 类 使 
用 @EnableWebMvc 注 解 ， 来 开局 对 Spring MVC 的 
配置 文 择 ， 这 样 我 们 束 可 以 重 写 这 个 类 的 方法 ， 
TERTIA E HE ° 

我 们 将 前 面 的 MyMvcConfig 配 置 类 继承 
WebMvcConfigurerAdapter， 本 章 若 不 做 特别 说 
E ， 则 天 于 配置 的 相关 内 容 都 在 MyMvcConfig 里 
编写 。 


4.4.1 静态 资源 映射 


1.52 H8 

程序 的 静态 文件 (s^ css^ AA) 等 需要 直 
接 访问 ， 这 时 我 们 可 以 在 配置 里 重 写 
addResourceHandlers 方 法 来 实现 。 


2. 示 例 


(1) 添加 静态 资源 
同上， 我 们 在 src/main/resources 下 建立 
assets/js 目 永 ， 并 复制 一 个 jqueryjs 放 置 在 此 目 永 
下 ， 如 图 4-6 所 示 。 
28 src/main/resources 
v [= assets 


v Bis 


jquery.js 


v (= views 


=) indexjsp 


Al4-6 ”复制 一 个 jquery.js 放 置 在 assetsl.js 目 录 下 
配置 代码 : 


package com.wisely.highlight springmvc4; 


import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
import 
org.springframework.web.servlet.config.annotation.EnableWebM 
VC; 

import 
org.springframework.web.servlet.config.annotation.ResourceHa 


ndlerRegistry; 

import 
org.springframework.web.servlet.config.annotation.WebMvcConf 
igurerAdapter; 

import 
org.springframework.web.servlet.view.InternalResourceViewRes 
olver; 

import org.springframework.web.servlet.view.JstlView; 


QConfiguration 

@EnablewebMvc//1 
QComponentScan("com.wisely.highlight springmvc4") 

public class MyMvcConfig extends WebMvcConfigurerAdapter{//2 


QBean 

public InternalResourceViewResolver viewResolver(){ 
InternalResourceViewResolver viewResolver - 

new InternalResourceViewResolver(); 

viewResolver.setPrefix("/WEB-INF/classes/views/"); 
viewResolver.setSuffix(".jsp"); 
viewResolver.setViewClass(JstlView.class); 
return viewResolver; 


j 


QOverride 
public void addResourceHandlers(ResourceHandlerRegistry 


registry) ( 


registry.addResourceHandler("/assets/**").addResourceLocatio 
ns("classpath:/assets/");//3 


j 


代码 解释 


(!(9EnableWebMvc7T/HSpringMVC x FF, 4 
无 此 句 ， 重 写 WebMvcConfigurerAdapter 方 法 无 
iY o 


s 


SD 


(2 继承 WebMvcConfigurerAdapter 类 ， 重 写 其 
方法 可 对 Spring MVC 进 行 配置 。 


@addResourceLocations 指 的 是 文件 放置 的 目 
3K, addResourceHandlerfR HJ 3e] / 28 Bs EJ Jj IR] BS 


径 Q 
44.2 RAE 


1.53 H8 


拦截 器 (Interceptor) 实现 对 每 一 个 请 求 处 理 
前 后 进行 相关 的 业务 处 理 ， 类 似 于 Servlet 的 


Filter ° 


可 让 普通 的 Bean 实 现 HanlderInterceptor 接 口 或 
者 继 厌 HandlerInterceptorAdapter 关 来 实现 目 定 义 
f= BAS ° 


通过 重 写 WebMvcConfigurerAdapter 的 
addInterceptors 77 35233: FE X HJT- Rss, ANT 
iC — “Tal BUT eas TT ACA, MESS X. 
为 计算 每 一 次 请 求 的 处 理 时 间 。 


2. 示 例 


(1) 示例 拦截 器。 


package com.wisely.highlight springmvc4.interceptor; 


import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.springframework.web.servlet.ModelAndView; 

import 
org.springframework.web.servlet.handler.HandlerInterceptorAd 
apter; 


public class DemoInterceptor extends 
HandlerInterceptorAdapter {//1 


QOverride 
public boolean preHandle(HttpServletRequest request, //2 
HttpServletResponse response, Object handler) 
throws Exception { 
long startTime - System.currentTimeMillis(); 
request.setAttribute("startTime", startTime); 
return true; 


j 


QOverride 
public void postHandle(HttpServletRequest request, //3 
HttpServletResponse response, Object handler, 
ModelAndView modelAndView) throws Exception { 
long startTime - (Long) 
request.getAttribute("startTime"); 
request.removeAttribute("startTime"); 
long endTime - System.currentTimeMillis(); 
System.out.printLn(" 本 次 请 求 处 理 时 间 为 :" + new 
Long(endTime - startTime)+"ms"); 
request.setAttribute("handlingTime", endTime - 
startTime); 


I 


代码 解释 


(继承 HandlerInterceptorAdapter 类 来 实现 目 定 
义 拦截 器 。 
(Co) 重 写 preHandle 方 法 ， 在 请 求 发 生前 执行 。 
(3 引 重 写 postHandle 方 法 ， 在 请 求 完 成 后 执行 。 
(2) 配置 。 


QBean //1 
public DemoInterceptor demoInterceptor()1 
return new DemoInterceptor(); 


QOverride 

public void addInterceptors(InterceptorRegistry 
registry) (//2 

registry.addInterceptor(demoInterceptor()); 


代码 解释 

配置 拦截 器 的 Bean 。 

(2H 5j addInterceptors7; 15, EHH RHE 。 
(3) 运行 。 在 浏览 器 访问 任意 路 径 ， 如 


http://localhost: 8080/highlight_springmvc4/index , 
查看 控制 台 如 图 4-7 所 示 。 


: 15:07:44.482 o.s. .servlet.Disp 
: 15:07:44.485 0.S.w.s.m.m.a.Reques 
: 15:07:44.487 0.5.w.Ss.m.m.a.Reques 

15:07:44.488 o.s.web.servlet.Disp 


RANE: 12ms 


logbak: 15:07:44.503 o.s.web.servlet.Disp 
logbak: 15:07:44.506 o.s.web.servlet.vie 
logbak: 15:07:44.516 o.s.web.servlet.Disp 


图 4-7 dme 


4.4.3 @ControllerAdvice 


通过 @ControllerAdvice， 我 们 可 以 将 对 于 控 
制 古 的 全 局 配置 放置 在 同一 个 位 置 ， 注 解 了 
@Controller 的 关 的 方法 可 使 用 
@ExceptionHandler ` @InitBinder ^ 
@ModelAttribute 注 解 到 方法 上 ， 这 对 所 有 注解 了 
(QRequestMappingH f: tl a8 41H 7J 158 AX. 9 


@ExceptionHandler: 用 于 全 局 处 理 控制 絮 里 
的 异常 。 


@InitBinder: 用 来 议 置 WebDataBinder， 
WebDataBinder 用 来 目 动 绑 定 前 台 请 求 参 数 到 
Model 中 。 


@ModelAttribute: @ModelAttribute 本 来 的 作 


用 是 绑 定 键 值 对 到 Model 里 ， 此 处 是 让 全 局 的 
@RequestMapping 都 能 获得 在 此 处 设置 的 键 值 
对 。 


本 万 将 演示 使 用 @ExceptionHandler 处 理 全 局 


异 币 ， 更 人 性 化 的 将 异 第 输出 给 用 户 。 
2. 示 例 
(1) 定制 ControllerAdvice。 


package com.wisely.highlight springmvc4.advice; 


import org.springframework.ui.Model; 
import org.springframework.web.bind.WebDataBinder; 
import 


org.springframework.web.bind.annotation.ControllerAdvice; 


import 


org.springframework.web.bind.annotation.ExceptionHandler; 
import org.springframework.web.bind.annotation.InitBinder 


import 
org.springframework.web.bind.annotation.ModelAttribute; 


import org.springframework.web.context.request.WebRequest 


import org.springframework.web.servlet.ModelAndView; 


@ControllerAdvice //1 
public class ExceptionHandlerAdvice { 


@ExceptionHandler(value = Exception.class) //2 


public ModelAndView exception(Exception exception, 
WebRequest request) ( 
ModelAndView modelAndView - new 
ModelAndView("error");// error 页 面 
modelAndView.addObject("errorMessage", 
exception.getMessage()); 
return modelAndView; 


QModelAttribute //3 
public void addAttributes(Model model) { 
model.addAttribute("msg", "额外 信息 "); //3 


@InitBinder //4 
public void initBinder(WebDataBinder webDataBinder) { 
webDataBinder.setDisallowedFields("id"); //5 


代码 解释 


@® @ControllerAdvice  44—- Tz Hil 28 B , 
@ControllerAdvice 组 全 了 @Component 注 解 ， 所 以 
目 动 注册 为 Spring 的 Bean ° 


@@ExceptionHandler 在 此 处 定义 全 局 处 理 ， 
通过 @ExceptionHandler 的 value 属 性 可 过 滤 拦 规 的 
条 件 ， 在 此 处 我 们 可 以 看 出 我 们 拦截 所 有 的 


Exception ? 


(3) 此 处 使 用 @ModelAttribute 注 解 将 键 值 对 添 
加 到 全 局 ， 所 有 注解 的 @RequestMapping 的 方法 
可 获得 此 键 值 对 。 


(4) 通 过 @InitBinder 注 解 定制 WebDataBinder 。 


@) 此 处 演示 忽略 request 参 数 的 id， 更 多 关于 
WebDataBinderl'JBU E, i$ webDataBinderllJ 
API 文 档 ° 


(2) 演示 控制 器 。 


package com.wisely.highlight springmvc4.web.ch4 4; 


import org.springframework.stereotype.Controller; 
import 
org.springframework.web.bind.annotation.ModelAttribute; 
import 
org.springframework.web.bind.annotation.RequestMapping; 


import com.wisely.highlight springmvc4.domain.DemoObj; 


@Controller 
public class AdviceController { 

@RequestMapping("/advice" ) 

public String getSomething(@ModelAttribute("msg") String 
msg Demoobj obj){//1 


throw new IllegalArgumentException("dE7 IK, BAA 
ix/"-"3EBHgModelAttribute:"- msg); 


j 


(3) 异常 展示 页 面 。 


在 src/main/resources/views F, #1£error.jsp, 
内 容 如 下 : 


«90 taglib uri="http://java.sun.com/jsp/jstl/core" 
prefix="c" %> 
<%@ page language="java" contentType="text/html; 
charset=UTF-8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>@ControllerAdvice Demo</title> 


</head> 
<body> 
${errorMessage} 
</body> 
</html> 
SZ 
(4) 运行 。 


访问 http:Wlocalhost: 
8080/highlight springmvc4/advice? 
id=1&name=xx ° 


HRA 4 DemoObj, idfibjEPRT, 有 旦 获得 了 
@ModelAttribute 的 msg 信 息 ， 如 图 4-8 所 示 。 


v 9 msg | "SME" (id=75)| 
& hash 0 
a value (id 293) 

v 9 obj DemoObj (id=80) 
a id 
B name "xx" (id=91) 


图 4-8 ”页 面 效果 


页 面 效 末 如 图 4-9 所 示 ° 


@ControllerAdvice x 
e QC | [5 localhost:8080/highlight springmvc4/advice?id- 1&name 


非常 抱歉 ， 参 数 有 误 / 来 自 同 odelAttribute: 额 外 信息 


图 4-9 页面 效果 
444 其 他 配置 


1. 快 捷 的 ViewController 


在 4.2.2 契 我 们 配置 页 面 罗 同 的 时 候 使 用 的 代 
ROI P: 


QRequestMapping("/index")//2 
public String hello(){ 
return "index"; //3 


} 


此 处 无 任何 业务 处 理 ， 只 是 简单 的 页 面 转 
问 ， 写 了 至 少 三 行 有 效 代 码 ; 在 实际 开发 中 会 涉 
RRB OE, BAS SR ie 
我 们 可 以 通过 在 配置 中 重 写 addViewControllers 来 
fal HF, BO: 


QOverride 
public void addViewControllers(ViewControllerRegistry 
registry) { 


registry.addViewController("/index'").setViewName("/index"); 


这 样 实现 的 代码 更 简 洛 ， 管 理 更 集中 。 
2. 路 径 匹配 参数 配置 


在 Spring MVC 中 ， 路 径 参 数 如 有 末 市 “.” 的 
话 ,“.” 后 面 的 值 将 被 忽略 ， 例 如 ， 访 问 
http://localhost: 


8080/highlight_ Vari bi cd iE Jt 
时 “.” 后 面 的 yy 航 忽 略 ， 如 独 4-10 所 示 。 


€ C localhost:8080/highlight springmvc4/anno/pathvar/xx.y 


url:http: //localhost: 8080/highlight springmvc4/anno/pathvar/xx. yy can access, ste xx | 


图 4-10 忽略 “.” 后 面 的 yy 


通过 重 写 configurePathMatch 方 法 可 不 名 
略 “.” 后 面 的 参数 ， 代 码 如 下 : 


QOverride 

public void configurePathMatch(PathMatchConfigurer 
configurer) ( 

configurer.setUseSuffixPatternMatch(false); 


这 时 再 访问 http:Wlocalhost: 
8080/highlight springmvc4/anno/pathvar/xx.yy , Wi 
可 以 接受 “.” 后 面 的 yy 了 ， 如 图 4-11 所 示 。 


€ C | D localhost:8080/highlight springmvc4/anno/pathvar/xx.y 


url:http: // localhost: 8080/hizhlizht springmvc4/anno/pathvar/xx. yy can access, str: [xx. yy 


图 4-11 接受 “.” 后 面 yy 
3. 5H Z Fi 


更 多 配置 请 查看 WebMvcConfigurerAdapter 类 
的 API。 因 其 是 WebMvcConfigurer 接 口 的 实现 ， 所 
以 WebMvcConfigurer 的 API 内 的 方法 也 可 以 用 来 配 
AMVC ° PERII E T 
WebMvcConfigurerAdapter 和 WebMvcConfigurer 的 
Uf o 


4.WebMvcConfigurerAdapter 


public abstract class WebMvcConfigurerAdapter implements 
WebMvcConfigurer { 

QOverride 

public void addFormatters(FormatterRegistry registry) { 


QOverride 

public void 
configureMessageConverters(List<HttpMessageConverter<?>> 
converters) { 


@Override 
public void 


extendMessageConverters(List<HttpMessageConverter<?>> 
converters) { 

} 

QOverride 

public Validator getValidator() { 

return null; 

} 

QOverride 

public void 
configureContentNegotiation(ContentNegotiationConfigurer 
configurer) ( 

} 

QOverride 

public void configureAsyncSupport(AsyncSupportConfigurer 
configurer) ( 

j 

QOverride 

public void configurePathMatch(PathMatchConfigurer 
configurer) ( 

} 

QOverride 

public void 
addArgumentResolvers(List<HandlerMethodArgumentResolver> 
argumentResolvers) { 

} 

QOverride 

public void 
addReturnValueHandlers(List<HandlerMethodReturnValueHandler> 
returnValueHandlers) { 

j 

QOverride 

public void 
configureHandlerExceptionResolvers(List«HandlerExceptionReso 
lver» exceptionResolvers) { 

} 

QOverride 

public MessageCodesResolver getMessageCodesResolver() { 

return null; 
} 


QOverride 
public void addInterceptors(InterceptorRegistry 
registry) { 


QOverride 
public void addViewControllers(ViewControllerRegistry 


registry) ( 


QOverride 
public void configureViewResolvers(ViewResolverRegistry 
registry) { 


QOverride 
public void addResourceHandlers(ResourceHandlerRegistry 
registry) { 


@Override 

public void 
configureDefaultServletHandling(DefaultServletHandlerConfigu 
rer configurer) { 


5.WebMvcConfigurer 


public interface WebMvcConfigurer { 


void addFormatters(FormatterRegistry registry); 

void 
configureMessageConverters(List<HttpMessageConverter<?>> 
converters); 

void extendMessageConverters(List<HttpMessageConverter<? 
>> converters); 

Validator getValidator(); 

void 
configureContentNegotiation(ContentNegotiationConfigurer 
configurer); 

void configureAsyncSupport(AsyncSupportConfigurer 
configurer); 

void configurePathMatch(PathMatchConfigurer configurer); 

void 
addArgumentResolvers(List<HandlerMethodArgumentResolver> 
argumentResolvers); 


void 
addReturnValueHandlers(List<HandlerMethodReturnValueHandler> 
returnValueHandlers); 


void 
configureHandlerExceptionResolvers(List«HandlerExceptionReso 
lver» exceptionResolvers); 

void addInterceptors(InterceptorRegistry registry); 

MessageCodesResolver getMessageCodesResolver(); 

void addViewControllers(ViewControllerRegistry 
registry); 

void configureViewResolvers(ViewResolverRegistry 
registry); 

void addResourceHandlers(ResourceHandlerRegistry 
registry); 

void 
configureDefaultServletHandling(DefaultServletHandlerConfigu 
rer configurer); 


j 


45 Spring MVC 的 高 级 配置 


45.1 文件 上 传 配 置 


1.3 R8 


i 目 里 经 草 要 用 的 功能 ， 
Spring MVC 通 过 配 置 一 个 MultipartResolver 来 上 传 
文件 。 


在 Spring 的 控制 瑚 中 ， 通 过 MultipartFile file 来 
接收 文件 ， 通 过 MultipartFile[]files 接 收 多 个 文件 上 
人 


2. 示 例 
(1) 添加 文件 上 传 依赖 。 


«groupId»commons-fileupload«/groupId» 
<artifactId>commons-fileupload</artifactId> 
<version>1.3.1</version> 

</dependency> 

«1-- 非 必 需 ， 可 简化 I/0 操 作 --> 

<dependency> 
<groupId>commons-io</groupId> 


<artifactId>commons-io</artifactId> 
<version>2.3</version> 
</dependency> 


(2) 上 传 页 面 。 在 src/main/resources/views 下 
#tupload.jsp ° 


<%@ page language="java" contentType="text/html; 
charset=UTF-8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>upload page</title> 


</head> 
<body> 


<div class="upload"> 
«form action="upload" enctype="multipart/form-data" 
method="post"> 
«input type="file" name="file"/><br/> 
<input type="submit" value=" 上 传 "> 
</form> 
</div> 


</body> 
</html> 


(3) 添加 转 辐 到 upload 页 面 的 


ViewController ? 


QOverride 
public void addViewControllers(ViewControllerRegistry 


registry) { 
registry.addViewController("/index'").setViewName("/index"); 


registry.addViewController("/toUpload").setViewName("/upload 
n); 
} 


(4) MultipartResolver 配 置 ° 


QBean 
public MultipartResolver multipartResolver() { 
CommonsMultipartResolver multipartResolver - 
new CommonsMultipartResolver(); 
multipartResolver.setMaxUploadSize(1000000); 
return multipartResolver; 


(5) Fathi ae ° 


package com.wisely.highlight_springmvc4.web.ch4_5; 


import java.io.File; 
import java.io.IOException; 


import org.apache.commons.io.FileUtils; 

import org.springframework.stereotype.Controller; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.ResponseBody; 
import org.springframework.web.multipart.MultipartFile; 


@Controller 
public class UploadController { 


@RequestMapping(value = "/upload",method = 
RequestMethod.POST) 
public @ResponseBody String upload(MultipartFile file) 


{//1 


try { 
FileUtils.writeByteArrayToFile(new 
File("e:/upload/"+file.getOriginalFilename()), 
file.getBytes()); //2 
return "ok"; 
} catch (IOException e) { 
e.printStackTrace(); 
return "wrong"; 


j 


代码 解释 
D FA MultipartFile file 接 受 上 传 的 文件 。 


2) 使 用 FileUtils.writeByteArrayIoFile 快 速写 文 
件 到 磁盘 。 


(6) 运行 。 访 问 http://localhost: 
8080/highlight_springmvc4/toUpload， 如 图 4-12 所 
ZJN [o] 


g upload page x 
€ C | D localhost:8080/highlight_springmvc4/toUpload 


| 选择 文件 ] log txt 
ri 


图 4-12 ”访问 


单 击 “上 传 ” 按 钮 后 ， 查 看 e: upload X EX, 
如 图 4-13 所 示 。 


图 4-13 ”查看 upload 文 件 夹 


4.5.2” 目 定义 HttpMessageConverter 


1.3 R8 


HttpMessageConverterze Fi 2 Ab Xlrequestfll 
response 里 的 数据 的 。Spring 为 我 们 内 置 了 大 量 的 
HttpMessageConverter， 例 如 ， 
MappingJackson2HttpMessageConverter ^ 
StringHttpMessage Converters » ATHAR B XE. 
义 的 HttpMessageConverter， 并 注册 这 个 
HttpMessageConverter 到 Spring MVC 。 


2. 不 例 
(1) BE X.HttpMessageConverter ° 


package com.wisely.highlight springmvc4.messageconverter; 


import java.io.IOException; 
import java.nio.charset.Charset; 


import org.springframework.http.HttpInputMessage; 

import org.springframework.http.HttpOutputMessage; 

import org.springframework.http.MediaType; 

import 
org.springframework.http.converter.AbstractHttpMessageConver 
ter; 

import 
org.springframework.http.converter.HttpMessageNotReadableExc 
eption; 

import 
org.springframework.http.converter.HttpMessageNotWritableExc 
eption; 

import org.springframework.util.StreamUtils; 


import com.wisely.highlight springmvc4.domain.DemoObj; 


public class MyMessageConverter extends 
AbstractHttpMessageConverter«DemoObj» {//1 


public MyMessageConverter() { 
super(new MediaType("application", "x- 
wisely",Charset.forName("UTF-8")));//2 
} 


/** 
* 3 
*/ 


QOverride 
protected DemoObj readInternal(Class«? extends DemoObj» 
clazz, 
HttpInputMessage inputMessage) throws 
IOException, 


HttpMessageNotReadableException { 
String temp - 
StreamUtils.copyToString(inputMessage.getBody(), 


Charset.forName("UTF-8")); 

String[] tempArr = temp.split("-"); 

return new DemoObj(new Long(tempArr[0]), 
tempArr[1]); 


T 
QOverride 
protected boolean supports(Class<?> clazz) ( 
return DemoObj.class.isAssignableFrom(clazz); 


QOverride 
protected void writelnternal(DemoObj obj, 
HttpOutputMessage outputMessage) 
throws IOException, 
HttpMessageNotWwritableException { 
String out = "hello:" + obj.getId() + "-" 
+ obj.getName(); 
outputMessage.getBody().write(out.getBytes()); 


代码 解释 


继承 AbstractHttpMessageConverter 接 口 来 实 
现 目 定义 的 HttpMessageConverter ° 


新 建 一 个 我 们 目 定 义 的 媒体 类 型 


application/x-wisely ° 


(9) 重 写 readIntenal 方 法 ， 处 理 请 求 的 数据 。 代 
码 表 明 我 们 处 理由 “-” 隅 开 的 数据 ， 并 转 成 
DemoObj 的 对 象 。 


(4) 表 明 本 HttpMessageConverter 只 处 理 
DemoObj 这 个 类 。 


( 引 重 写 writeInternal， 处 理 如 何 输 出 数据 到 
— "此 例 中 ， 我 们 在 原样 输出 前 面 加 
“hello: ” ° 


(2) 配置 。 在 addViewControllers 中 添加 
viewController 映 射 页 面 访 问 演示 页 面 ， 代 码 如 
F: 


registry.addViewController("/converter").setViewName("/conve 
rter"); 


配置 目 定 义 的 HttpMessageConverter 的 Bean ， 
在 Spring MVC 里 注册 HttpMessageConverter 有 两 个 
方法 : 

e configureMessageConverters: Hi #73 mI 
Spring MVC 默 认 注 册 的 多 个 
HttpMessageConverter ? 
extendMessageConverters: 仅 添 加 一 个 目 定 义 
HJHttpMessageConverter, AI s SATA 


HttpMessageConverter ? 


所 以 在 此 例 中 我 们 重 写 


extendMessageConverters: 


QOverride 
public void 
extendMessageConverters(List<HttpMessageConverter<?>> 
converters) { 
converters.add(converter()); 


j 


QBean 
public MyMessageConverter converter()( 
return new MyMessageConverter(); 


1 


(3) 演示 控制 器 。 


package com.wisely.highlight springmvc4.web.ch4 5; 


import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestBody; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.ResponseBody; 


import com.wisely.highlight springmvc4.domain.DemoObj; 


@Controller 
public class ConverterController { 


@RequestMapping(value = "/convert", produces = { 
"application/x-wisely" }) //1 

public @ResponseBody DemoObj convert (@RequestBody 
DemoObj demoObj) { 


return demoObj; 


代码 解释 
指定 返回 的 媒体 类 型 为 我 们 目 定义 的 媒体 


关 型 application/x-wisely ° 


(4) 演示 页 面 。 在 src/main/resources 下 新 建 


conventer.jsp: 


<%@ page language="java" contentType="text/html; 
charset=UTF-8" 
pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
«html» 
<head> 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>HttpMessageConverter Demo</title> 
</head> 
<body> 
<div id="resp"></div><input type="button" 
onclick="req();" value=" 请 求 "/> 
<script src="assets/js/jquery.js" type="text/javascript"> 
</script> 
<script> 
function req(){ 
$.ajax({ 
url: "convert", 
data: "1-wangyunfei", //1 
type:"POST", 
contentType:"application/x-wisely", //2 
success: function(data) { 
$("#resp").html(data); 
} 


}); 


j 


«/script» 
</body> 
</html> 
代码 解释 


注意 这 里 的 数据 格式 ， 后 台 处 理 按 此 格式 
处 理 ， 用 “-? 陋 开 。 


@contentType 设 置 的 媒体 类 型 是 我 们 目 定 义 
HJapplication/x-wisely ° 


(5) 运行 。 访 问 http://localhost: 
8080/highlight_springmvc4/converter, 如 图 4-14 所 
ZJN [e] 


HttpMessageConv: x 


« Q | D localhost:8080/highlig 


请 求 


图 4-14 ”访问 http:/localhost: 
8080/highlight springmvc4/converter 


单 击 “请 求 "按钮 ， 做 如 下 观察 。 
请 求 类 型 如 图 4-15 所 示 。 


X | Headers | Preview Response Cookies Timing 


Y General 
Remote Address: [::1]:8080 
Request URL: nttp://localhost:8080/highlight springmvc4/convert 
Request Method: POST 
Status Code: @ 200 OK 


Content-Type: application/x-wisely 
Date: Sun, 14 Jun 2015 07:05:25 GMT 
Server: Apache-Coyote/1.1 
Transfer-Encoding: chunked 
Y Request Headers view source 
Accept */* 
Accept-Encoding: gzip, deflate 
Accept-Language: zh-CN,zh;qz80.8 
Connection: keep-alive 
Cookie: J5ESSIONID-8A0E5669EF7E3E7303A9EEC25F626DA2 
Host: localhost:8080 
Origin: http://1localhost:8080 
Referer: http://localhost:8080/highlight springmvc4/converter 
User-Agent: Mozilla/5.@ (Windows NT 10.0; WOW64) AppleWebKit/53 
X-Requested-With: XMLHttpRequest 


Request Payload 
1-wangyunfei 


图 4-15 “请 求 类 型 


后 人 台 获 得 我 们 目 定义 的 数据 格式 ， 如 图 4-16 


ame Value 
© this ConverterController (id=122) 
9 demoObj DemoObj (id- 123) 
a id Long (id-132) 
8 name "wangyunfei" (id- 136) 


Ela-16 Bog LARGER St 
TH IBARRA Éd4-17 AT AR ° 


€ C | D localhost:8080/highlight springmvc4/converter 


hello:l-wangyunfei 
请 求 


图 4-17 ”页面 效果 
4.5.3 ARS zm AES DCN 


AR 5 ta FETS CIN EBT] TR T AC BOA t 
用 ， 可 能 于 期 很 多 人 的 解决 方案 是 使 用 Ajax 回 服 
AS RR EITHER. TM bias ss HJ ess Ay IH] AA AR 
Fy MGV E, AAAA BUE TRIER I E s 
il, PARRI T HROSSmHJHs7] 9 


AKT PU A AR OS aa TEI HJ RET: 
SAP via ARS i IAT, ARAMA TIME 
请 求 不 放 ， 等 有 数据 更 新 的 时 候 才 返回 给 客户 
Mn, SA PMS Aa, FEARS i IAT 
OK, JAMA un 9 RPT SU ERS D ARS at 
的 请 求 数量 ， 大 大 减少 了 服务 器 的 压力 。 

ER T AR as EDU DEAF, VET TI 
的 双向 通信 的 技术 一 一 webSocket， 我 们 将 在 本 书 
第 三 部 分 实战 Spring Boot 中 演示 。 


本 下 将 提供 基于 SSE (Server Send Event 服 务 
端 发 送 事件 ) 的 服务 器 端 推送 和 基于 Servlet 
3.0+ 的 异步 方 法 竺 性 ， 其 中 第 一 种 方式 需要 淅 式 
浏 顺 万 的 文 持 ， 第 二 种 方式 是 跨 浏 斋 右 的 。 


1.SSE 
(1) 演示 控制 器 。 


package com.wisely.highlight springmvc4.web.ch4 5; 
import java.util.Random; 


import org.springframework.stereotype.Controller; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.ResponseBody; 


@Controller 
public class SseController { 


@RequestMapping(value="/push", produces="text/event - 
stream") //1 
public @ResponseBody String push(){ 
Random r = new Random(); 
try { 
Thread.sleep(5000); 
) catch (InterruptedException e) { 
e.printStackTrace(); 


j 


return "data:Testing 1,2,3" + r.nextInt() +"\n\n"; 


代码 解释 


注意 ， 这 里 使 用 输出 的 媒体 类 型 为 
text/event-stream ， 这 是 服务 硕 疹 SSE 的 文 择 ， 本 例 
演示 每 5 秒 钟 回 浏 贤 姨 推送 随机 消 恩 。 


(2) 演示 页 面 。 在 src/main/resources/views 下 
新 建 sse.jsp: 


«90 taglib uri="http://java.sun.com/jsp/jstl/core" 
prefix="c" 9 
<%@ page language="java" contentType="text/html; 
charset=UTF-8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>SSE Demo</title> 


</head> 
<body> 


<div id="msgFrompPush"></div> 

«script type="text/javascript" src="<c:url 
value="assets/js/jquery.js" />"></script> 
<script type="text/javascript"> 


if (!!window.EventSource) { //1 
var source = new EventSource('push'); 
sats 
source.addEventListener('message', function(e) {//2 
st=e.datat"<br/>"; 
$("4msgFrompPush").html(s); 


J): 


source.addEventListener('open', function(e) { 


console. log("i##2477F."); 
}, false); 


source.addEventListener('error', function(e) { 
if (e.readyState == EventSource.CLOSED) { 
console.10g(" 连 接 关闭 "); 
} else { 
console.log(e.readyState); 


} 
}, false); 
} else { 
console .10g(" 你 的 浏览 器 不 支持 SSE")， 


</script> 
</body> 
</html> 


代码 解释 
@EventSourcex} RA A HH bias A 
(Chrome ` Firefox) 等 ，EventSource 是 SSE 的 客 
Fn; 


DISSER P mAT, EARRA nin itn HE 
SATA ^ 


(3) 配置 。 
添加 转 辐 sse.jsp 页 面 的 映射 : 


registry.addViewController("/sse").setViewName("/sse"); 


(4) 运行 。 访 问 http://localhost: 
8080/highlight_springmvc4/sse， 如 图 4-18 所 示 。 


€ QC | D localhost:8080/highlight springmvc4/sse 
Testing 1, 2, 3963088277 
Testing 1, 2, 3-171060687 
Testing 1, 2, 3-1406895476 
Testing 1, 2, 3-1934411557 
Testing 1, 2, 3-1446959901 
Testing 1, 2, 3-1934192666 
sse 200 document 
jquery 304 
push 200 
push 200 
push 200 
pust [penang] 


图 4-18 ”运行 效果 
2.Servlet 3.0+ 异 步 方 法 处 理 


(1) 开启 异步 方法 文 持 : 


Dynamic servlet = 
servletContext.addServlet("dispatcher", new 
DispatcherServlet(ctx)); //3 

servlet.addMapping("/"); 
servlet.setLoadOnStartup(1); 
servlet.setAsyncSupported(true);//1 


代码 解释 
中 此 句 开 局 异步 方法 文 持 。 


(2) TRAN TE Hl a: 


package com.wisely.highlight_springmvc4.web.ch4_5; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.ResponseBody; 
import 
org.springframework.web.context.request.async.DeferredResult 


/ 
import com.wisely.highlight springmvc4.service.PushService; 


@Controller 

public class AysncController { 
@Autowired 
PushService pushService; //1 


QRequestMapping("/defer") 
QResponseBody 


public DeferredResult<String> deferredCall() ( //2 
return pushService.getAsyncUpdate( ); 
} 


代码 解释 


THES A SE D gs MT 
程 返 回 一 个 DeferredResult， 这 里 的 DeferredResult 
是 从 pushService 中 获得 的 。 


定时 任务 ， 定 时 更 新 DeferredResult。 


(2) 返 回 给 客户 端 DeferredResult。 
(3) 定时 任务 : 


package com.wisely.highlight springmvc4.service; 


import org.springframework.scheduling.annotation.Scheduled; 
import org.springframework.stereotype.Service; 

import 
org.springframework.web.context.request.async.DeferredResult 


, 


@Service 
public class PushService { 
private DeferredResult<String> deferredResult; //1 


public DeferredResult<String> getAsyncUpdate() {//1 
deferredResult = new DeferredResult<String>(); 
return deferredResult; 


} 


@Scheduled(fixedDelay = 5000) 
public void refresh() {//1 
if (deferredResult != null) { 
deferredResult.setResult (new 
Long(System.currentTimeMillis()) 
.toString()); 


j 


代码 解释 


(DD) 在 PushService 里 产生 DeferredResult 给 控制 
龙 使 用 ， 通 过 @Scheduled 注 解 的 方法 定时 更 新 
DeferredResult ° 


Z2 


(4) 演示 页 面 
f£src/main/resources/views | #1 &&async.jsp: 


<%@ page language="java" contentType="text/html; 
charset=UTF-8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>servlet async support</title> 


</head> 

<body> 

<script type="text/javascript" src="assets/js/jquery.js"> 
</script> 

<script type="text/javascript"> 


deferred();//1 


function deferred(){ 
$.get('defer', function(data) { 
console.log(data); //2 
deferred(); //3 


3); 
«/script» 


«/body» 
«/html» 


代码 解释 


此 处 的 代码 使 用 的 是 jQuery 的 Ajax 请 求 ， 所 以 
TSCA ba at AR SEE [A] pel o 


页面 打 开 就 向 后 台 发 送 请 求 。 

在 控制 台 输 出 服务 端 推送 的 数据 。 
G@) 一 次 请 求 完成 后 再 向 后 台 发 送 请 求 。 
(5) 配置 。 


在 MyMvcConfig 上 开始 计划 任务 的 文 持 ， 使 
用 @EnableScheduling: 


QConfiguration 

@EnablewebMvc 

@EnableScheduling 
QComponentScan("com.wisely.highlight springmvc4") 

public class MyMvcConfig extends WebMvcConfigurerAdapter { 


} 
Ws JlviewController: 


registry.addViewController("/async").setViewName("/async"); 


(6) 运行 。 访 问 Pttp:Wlocalhost: 
8080/highlight_springmvc4/async， 如 图 4-19 所 示 。 


Name Status Type Initiator Size Time 

|_| async 200 docum... Other 804 B 73 ms 

|-| jqueryjs 304 script asyne:13 93B 20 ms 

| | defer 200 xhr jaueryjs:7829 161B 3.87 s 

|_| defer 200 xhr jquery.js:7829 161B 498s 

[ ] defer 200 xhr jquery.is:7829 1618 5.00s 
defer 200 xhr jquery.js:7829 161B 5.01s 
defer [ (pending) | xhr jquery.js:7829 OB Pending 


图 4-19 ”运行 效果 
控制 台 输 出 如 图 4-20 所 示 。 


Q Elements Network Sources Timeline » ^ y» o, 
© Y <topframe> v [O Preserve log 
1434278922775 async:20 
1434270927777 async:260 


1434270932778 async:28 
1434270937792 async:20 


1434270942794 async:20 
1434270947798 async:20 
1434270952801 async:20 
1434270957802 async:20 
1434270962805 async:20 
1434270967806 async:20 


图 4-20 ”控制 台 输 出 


4.6 Spring MVC 的 测试 
4.6.1 点睛 


测试 是 保证 软件 质量 的 关键 ， 所 以 我 们 在 “第 
一 部 分 点 睛 Spring 4.x”、“ 第 二 部 分 点 睛 Spring 
MVC 4.x” 和 “第 二 部 分 实战 Spring Boot” 中 都 将 会 
有 测试 相关 的 内 容 。 


在 第 一 部 分 ， 我 们 只 谈 了 简单 的 测试 。 在 本 
忆 ， 我 们 要 进行 一 些 和 Spring MVC 相 天 的 测试 ， 
主要 涉 太 探 制 疾 的 测试 。 


为 了 测试 Web 项 日 通常 不 需要 启动 项 目 ， 我 
们 需要 一 些 Servlet 相 关 的 模拟 对 象 ， 比 如 : 
MockMVC ^ MockHttpServletRequest ^ 
MockHttpServletResponse ` MockHttpSession<# ° 


在 Spring 里 ， 我 们 使 用 @WebAppConfiguration 
指定 加 我 的 ApplicationContext 是 一 个 
WebApplicationContext ° 


可 能 许多 人 ， 包 括 我 日 己 以 前 也 觉得 测试 有 
什么 用 ， 目 已 局 动 一 下 ， 扩 扩 弄 弄 ， 束 像 我 们 前 
面 的 例子 不 也 都 是 这 样 测试 的 吗 ? 其 实在 现实 开 
发 中 ， 我 们 是 先 有 和 需求 的 ， 也 就 是 说 完 知道 我 们 
想 要 的 是 什么 样 的 ， 然 后 按照 我 们 想 要 的 样子 去 
开发 。 在 这 里 我 也 要 引入 一 个 概念 叫 测 试 驱 动 开 
发 (Test Driven Development, TDD) ， 我 们 OX 
TAM) 按照 需求 和 完 写 一 个 目 已 预期 结果 的 测试 
用 例 ， 这 个 测试 用 例 刚 开始 肯定 征 僚 败 的 测 弃 ， 
随 看 不 断 的 编码 和 重 构 ， RS VU S 过 测 
试 ， 这 样 才 能 你 证 软件 的 质量 和 可 控 性 


在 下 面 的 示例 里 我 们 信 助 JUnit 和 Spring 
TestContext framework， 分 别 演示 对 普通 页 面 转 癌 
形 控 制 絮 和 RestController 进 行 测 试 。 


4.6.2 示例 


(1) 测试 依赖 : 


<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-test</artifactId> 
<version>${spring-framework.version}</version> 
<scope>test</scope> 
</dependency> 


<dependency> 


<groupId>junit</groupId> 

<artifactId>junit</artifactId> 

<version>4.11</version> 

<scope>test</scope> 
</dependency> 


代码 解释 


这 里 <scope>test</scope> 说 明 这 些 包 的 存活 坪 
—— TELLS RC ACA BC EGAN SE 
jar 


(2) 演示 服务 : 


package com.wisely.highlight springmvc4.service; 
import org.springframework.stereotype.Service; 


@Service 
public class DemoService { 


public String saySomething()( 
return "hello"; 


j 


(3) 测试 用 例 ， 在 src/tesUjava 下 : 


package com.wisely.highlight springmvc4.web.ch4 6; 


import static 
org.springframework.test.web.servlet.request.MockMvcRequestB 
uilders.get; 

import static 


org.springframework.test.web.servlet.result.MockMvcResultMat 
chers.content; 
import static 
org.springframework.test.web.servlet.result.MockMvcResultMat 
chers.forwardedUrl; 
import static 
org.springframework.test.web.servlet.result.MockMvcResultMat 
chers.model; 
import static 
org.springframework.test.web.servlet.result .MockMvcResultMat 
chers.status; 
import static 
org.springframework.test.web.servlet.result .MockMvcResultMat 
chers.view; 


import org.junit.Before; 

import org.junit.Test; 

import org.junit.runner.RunWith; 

import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.mock.web.MockHttpServletRequest; 
import org.springframework.mock.web.MockHttpSession; 

import 
org.springframework.test.context.ContextConfiguration; 
import 
org.springframework.test.context.junit4.SpringJUnit4ClassRun 
ner; 

import 
org.springframework.test.context.web.WebAppConfiguration; 
import org.springframework.test.web.servlet.MockMvc; 

import 
org.springframework.test.web.servlet.setup.MockMvcBuilders; 
import 
org.springframework.web.context.WebApplicationContext; 


import com.wisely.highlight springmvc4.MyMvcConfig; 
import com.wisely.highlight springmvc4.service.DemoService; 


QRunWith(SpringJUnit4ClassRunner.class) 

@ContextConfiguration(classes = {MyMvcConfig.class}) 

@WebAppConfiguration("src/main/resources") //1 

public class TestControllerIntegrationTests { 
private MockMvc mockMvc; //2 


@Autowired 


private DemoService demoService;//3 


@Autowired 
WebApplicationContext wac; //4 


@Autowired 
MockHttpSession session; //5 


@Autowired 
MockHttpServletRequest request; //6 


@Before //7 
public void setup() { 
this.mockMvc = 


MockMvcBuilders.webAppContextSetup(this.wac).build(); //2 
} 


QTest 
public void testNormalController() throws Exception{ 
mockMvc.perform(get("/normal")) //8 
.andExpect(status().isOk())//9 
.andExpect(view().name("page"))//10 
.andExpect(forwardedUrl("/WEB- 
INF/classes/views/page.jsp"))//11 
.andExpect(model().attribute("msg", 
demoService.saySomething()));//12 


} 


QTest 

public void testRestController() throws Exception{ 
mockMvc.perform(get("/testRest")) //13 
.andExpect(status().isOk()) 


.andExpect(content().contentType("text/plain;charset-UTF- 
8"))//14 


.andExpect(content().string(demoService.saySomething()));//1 


5 
į 


代码 解释 


D@WebAppConfiguration t fF ER E, HÆ 
F8 AA DIEAS ApplicationContexz& — ^ 
WebApplicationContext ° E AY) PETS EH ze Web bt 
源 的 位 置 ， 默 认为 srcmain/webapp， 本 例 修 改 为 


src/main/resources ? 
@MockMvc- 模 拟 MVC 对 象 ， 通 过 
MockMvcBuilders.webAppContextSetup 
(this.wac) .build () 初始 化 。 
(3) 可 以 在 测试 用 例 中 注入 Spring 的 Bean ° 
(4) 可 注入 WebApplicationContext ° 


( 引 可 注入 模拟 的 http session， 此 处 仪 作 演示 ， 
没有 使 用 。 


(6) 可 注入 模拟 的 http request， 此 处 仅 作 演示 ， 
没有 使 用 。 


DG@Before 在 测试 开始 前 进行 的 初始 化 工作 。 
(RU [a] /normal? t íT geti 2k ° 
(9) 预 期 控制 返回 状态 为 200 。 


d0 预 期 view 的 名 称 为 page 。 


QD 预期 页 面 转 同 的 真正 路 人 笃 为 /WEB- 
INF/classes/views/page.jsp ° 


(3 预期 model 里 的 值 是 
demoService.saySomething () 返回 值 hello ° 


Q3 EU. [H]/testRest t íT geti K ° 


QR EHARA 7 text/plain; 
charset-UTF-8 ° 


Q5 预 期 返回 值 的 内 容 为 
demoService.saySomething () 返回 值 hello ° 


此 时 运行 该 测试 效果 如 图 4-21 所 示 。 


gu JUnit 23 $2 $94 599 A E. Og 
Finished after 1.087 seconds 


| Runs 2/2  Btros 0 Failures: 2 | eS 


v Bu com.wisely.highlight springmvc4.web.ch4 6.T = Failure Trace A 


i] testRestController (0.075 s) 40 java.lang.AssertionError: Status expected:«20 ^ 
EJ testNormalController (0.006 s) 


at org.springframework.test.util.AssertionErr: 
at org.springframework.test.util.AssertionErr: 


at org.springframework.test.web.servlet.resu 


at org.springframework.test.web.servlet.Moc 


at com.wisely.highlight springmvc4.web.ch4 6.Tq 


at org.springframework.test.context.junit4.stz 


at org.springframework.test.context.junit4.stz 
at org.springframework.test.context Junit4.stz 
at org.springframework.test.context,junit4.Sp 


at org.springframework.test.context.junit4.Sp 
v 


r It. 


^l Hr ur Hr dE dl 


> 


^ 
wv 


图 4-21 测试 效果 
(4) 编写 普通 控制 器。 


package com.wisely.highlight springmvc4.web.ch4 6; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 

import 
org.springframework.web.bind.annotation.RequestMapping; 


import com.wisely.highlight springmvc4.service.DemoService; 


@Controller 

public class NormalController { 
@Autowired 
DemoService demoService; 


QRequestMapping("/normal") 
public String testPage(Model model) { 
model.addAttribute("msg", 


demoService.saySomething()); 
return "page"; 


i 


(5) 编写 普通 控制 器 的 演示 页 面 ， 在 


src/main/resources/views 下 新 建 page.jsp: 


<%@ page language="java" contentType="text/html; 
charset=UTF-8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 
«meta http-equiv="Content-Type" content="text/html; 
charset=UTF-8"> 
<title>Test page</title> 
</head> 
<body> 

<pre> 

Welcome to Spring MVC world 

</pre> 
</body> 
</html> 


(6) 编写 RestController 控 制 器 : 


package com.wisely.highlight springmvc4.web.ch4 6; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.ResponseBody; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.highlight springmvc4.service.DemoService; 


QRestController 
public class MyRestController { 


@Autowired 
DemoService demoService; 


@RequestMapping(value = "/testRest" 
, produces="text/plain;charset=UTF-8") 
public @ResponseBody String testRest(){ 
return demoService.saySomething(); 
} 


(7) 运行 测试 ， 效 果 加 图 4-22 所 示 。 


giu JUnit 23 ga 有 | € Ey "^H 
Finished after 1.112 seconds 
fit] com.wisely.highlight springmvc4.web.ch4 6.T 三 Failure Trace Ec 
« > 


图 4-22 ”测试 效果 


第 三 部 分 “实战 Spring Boot 


第 5 章 Spring Boot 基 础 


5.1 Spring Boot 概 述 


5.1.1 什么 是 Spring Boot 


PP 


随 看 动态 语言 的 流行 (Ruby ` Groovy ` 
Scala ^ Node.js) ，Java 的 开发 显得 格外 的 笨重 : 
AA WAGE > IK RAIA ACR ` BARA AE 
以 及 第 三 方 技术 集成 难度 大 。 


在 上 述 环境 下 ，Spring Boot 应 运 而 生 。 它 使 
用 “习惯 优 于 配置 ”( 项 目 中 存在 大 量 的 配置 ， 此 
外 还 内 置 一 个 习惯 性 的 配置 ， 让 你 无 须 手 动 进 行 
配置 ) 的 理念 让 你 的 项 目 快速 运行 起 来 。 使 用 


Spring Boot 很 容易 创建 一 个 独立 运行 (运行 jar， 
A teServletas) 、 谁 生产 级 别 的 基于 Spring 框架 
的 项 目 ， 使 用 Spring Boot 你 可 以 不 用 或 者 只 需要 
很 少 的 Spring 配置 。 


5.1.2 Spring Boot 核 心 功能 


1. 独 立 运行 的 Spring 项 目 


Spring Boot 可 以 以 jar 包 的 形式 独立 运行 ， 运 
行 一 个 Spring Boot 项 目 只 需 通 过 java-jar xx.jar 来 


运 人 条。 

2. ke Servlet 45 

Spring Boot PAJEN E Tomcat ` Jetty ak # 
Undertow， 这 样 我们 无 须 以 war 包 形式 部 署 项 目 。 


3. 提 供 starter 傈 化 Maven 配 置 


Spring 提供 了 一 系列 的 starter pom 来 催化 
Maven 的 依赖 加 载 ， 例 如 ， 当 你 使 用 了 spring- 
boot-starter-web 时 ， 会 目 动 加 入 如 图 5-1 所 示 的 依 
赖 包 。 


图 5-1 自动 加 入 的 依赖 包 


4. 目 动 配置 Spring 


Spring Boot 会 根据 在 类 路 径 中 的 jar 包 、 类 ， 
为 jar 包 里 的 类 自动 配置 Bean， 这 样 会 极 大 地 减少 
我 们 要 使 用 的 配置 。 当 然 ，Spring Boot 只 是 考虑 
了 大 多 数 的 开发 场景 ， 并 不 是 所 有 的 场景 ， 若 在 
实际 开发 中 我 们 需要 目 动 配置 Bean， 而 Spring 
m 则 可 以 自 定义 目 动 配置 ( 见 
6.573) ° 


5. 准 生产 的 应 用 监控 


Spring Boot 近 供 基 于 http、ssh、telnet 对 运行 
时 的 项 目 进行 监控 〈 见 第 10 章 ) 。 


6. 无 代码 生成 和 xml 配 置 


Spring Boot 的 神奇 的 不 AE [BI ANTE BOR 
实现 的 ， 而 是 通过 条 件 注 解 来 实现 时 ， 这 有 是 
Spring 4.x 提 供 的 新 特性 ， 在 3.5 广 有 过 简单 的 演 
示 ， 本 章 将 用 大 量 的 篇 幅 讲解 Spring Boot 实 现 的 
核心 技术 。 

Spring 4.x 提 倡 使 用 Java 配 置 和 注解 配置 组 


合 ， 而 Spring Boot 不 需要 任何 xml 配 置 即 可 实现 
Spring 的 所 有 配置 。 


5.1.3 Spring Boot 的 优 缺 点 


优点 

(1) 快速 构建 项 目 ; 

(2) 对 主流 开发 框架 的 无 配置 集成 ; 
A 0 0 


BH. 


mi 


(4) 提供 运行 时 的 应 用 监控 


(5) 极 大 地 提高 了 开发 、 部 署 效率 
(6) 与 云 计 算 的 天 然 集 成 。 
缺点 


(1) 书籍 文档 较 少 且 不 够 深入 ， 这 古 直 接 促 
使 我 写 这 本 书 的 原因 ; 


(2) 如 果 你 不 认同 Spring 框 架 ， 这 也 许 是 它 
的 缺点 ， 但 建议 你 一 定 要 使 用 Spring 框架 。 


5.1.4 关于 本 书 的 Spring Boot 版 本 


在 我 写 这 本 书 的 时 候 ，Spring Boot 的 最 新 正 
式 版 是 1.2.4.RELEASE ° Spring Boot 1.3.1.M2 里 程 
三 版 本 已 经 发 布 。 


Spring Boot 1.3.1.x 提 供 了 大 量 新 特性， 最 令 
人 瞩目 的 是 添加 了 spring-boot-devtools 来 进行 开发 
热 部 署 ， 本 书 将 以 Spring Boot 1.3.0 版 本 作为 演示 
讲解 版 本 。 


5.2. Spring Boot 快 速 搭 建 
5.2.1 http://start.spring.io 


(1) 打开 浏览 右 ， 在 地 址 栏 中 输入 
http://start.spring.io， 如 图 5-2 所 示 。 


Bootstrap your application now 


Project metadata Project dependencies 


Group 


Core Web 


Artifact 


Name 


图 5-2 ”打开 Spring.io 


(2) 填写 项 目 信 息 ， 如 图 5-3 所 示 。 


Project metadata 


Group 


图 5-3 ”填写 项 目 信息 
内 容 解 释 


(DD 我们 在 此 以 Maven 作 为 项 目 构 建 方 式 ， 
Spring Boot 还 支持 以 Gradle 作 为 项 目 构 建 工 具 ; 


部 闭 形 式 以 jar 包 形式 ， 当 然 也 可 以 用 传统 


的 war 包 形式 ， 我 们 将 在 10.2.2 下 进行 讲解 ; 


Javak ERI 32679 1.8, Spring Boot 最 低 要 


求 为 1.6， 和 Spring 框架 4.x 的 最 低 要 求 一 致 ; 


@Spring boot 还 文 持 以 Groovy 语 言 开 发 ， 考 虑 
到 本 书 的 受众 ， 本 书 以 Java 作 为 开发 语言 ; 


G@) 按 照 5.1.4 下 的 阐述 ， 选 择 Spring Boot 版 本 
为 1.3.0 里 程 碑 版 本 。 


(3) 选择 项 目 选 用 的 技术 (Blstarter 
pom) ， 如 图 5-4 所 示 。 


Project dependencies 
Core Web 
Security ivi Web 
AOP Websocket 
Atomikos (JTA) WS 
Bitronix (JTA) Jersey (JAX-RS) 
Cache Vaadin 
DevTools Rest Repositories 
HATEOAS 
Mobile 
Template Engines Data 
Freemarker JDBC 
Velocity JPA 
Groovy Templates MongoDB 
Thymeleaf Redis 
Mustache Gemfire 
Solr 
Elasticsearch 


图 5-4 选择 项 目 选 用 的 技术 


内 容 解释 


这 里 备 选 的 每 一 项 技术 都 是 Spring booth 
starter pom， 例 如 我 们 选中 的 Web ， 融 是 在 Maven 
里 依 顿 spring-boot-starter-web。 


当 这 些 技 术 的 starter ppm F, SAN 
术 相 天 的 Spring 的 Bean 将 会 科目 动 配 置 ， 我 们 将 在 


第 三 部 分 讲述 常用 的 starter pom 。 


(4) 下 载 代 码 ， 如 图 5-5 所 示 。 


O Facebook 
O LinkedIn 


O Twitter 


Ops 
© Actuator 


Lj Remote Shell 


Q Generate Project 


BB ch5 2 Lzip - 36048 3.21ESC& 


添加 解压 到 ”一 键 解压 删除 
会 [B] 党 |E chs 2 1zip\ch5_2_1 - 解 包 大 小 为 3.0 KB 


图 5-5 下载 代 码 
内 容 解释 


此 处 生成 的 是 一 个 简单 的 基于 Maven 的 项 
目 ， 无 任何 特别 ， 可 将 这 个 项 目 导 入 到 你 常用 的 
开发 工具 中 ( 见 附录 A.2。) 


5.2.2 Spring Tool Suite 


对 于 习惯 于 Eclipse 开发 项 目的 读者 ， 使 用 STS 
来 构建 Spring Boot 也 十 分 简单 。 


(1) 新 建 Spring Starter Project， 如 图 5-6 所 


[E sprin ing - Spring Tool Sui 
| File | | Edit Navigate Sea — Window Help 


| New Alt+ Shi ft N» H Spring Starter Project 
Open Fil IB Import Spring Getting Started Content 
Close Ctrl+W 七 Spring Project 


J? = 
Close All Ctrl+Shiftew |B Java Project 
_  |Q Static Web Project 
Ws (S Dynamic Web Project 


图 5-6 ”新 建 Spring Starter Project 


(2) 填写 项 目 信息 和 选择 技术 ， 如 图 5-7 所 


iz 


New Spring Starter Project 


ch5 2 2 


Type: Maven Project v 


Java Version: 18 v | 


Boot Version: — 1.3.0 M1 


Group com.wisely 


Artifact [h5 22 


Version 0.0.1-SNAPSHOT 


Description Spring Boot Setup Demo 


Package 
Dependencies 


[com.wisely.ch5_2_2 


DAMQP 
AWS Messaging 
[C] Batch 


| Cloud Bus AMQP 


Config Server 


L]AOP 
[ ]Actuator 
[ ]Bitronix (TA) 


[C] Cloud Connectors 


C] DevTools 


AWS 
[ ]Apache Derby 
[C] Cache 

Cloud Security 
C] Elasticsearch 


AWS JDBC 

[ ]Atomikos (UTA) 
Cloud Bootstrap 
Config Client 


Eureka 


Eureka Server 
[ ]Gemfire 
L]HSQLDB 
L]JDBC 
C Linkedin 
L] Mustache 
[C] Redis 
[C] Security 
Turbine AMQP 
Ows 


[C] Facebook Feign [| Freemarker 

[C] Groovy Templates [ ]H2 [ ]HATEOAS 
Hystrix Dashboard [ ]Integration 

口 JPA (Jersey UAX-RS) 

C] Mobile [L ]MongoDB 
OAuth2 [_] PostgreSQL 

[ ]Rest Repositories Ribbon 

{_ | Thymeleaf Turbine 

[ ]Vaadin 口 Velocity 

[ ]Websocket Zuul 


Hystrix 
[DJMS 
C] Mail 
C] MySQL 
[| Remote Shell 
C] Solr 
[ ] Twitter 
[vi Web 


D < Back 


| Next> | 


图 5-7 
(3) 项 目 结构 如 图 5-8 所 示 。 


填写 项 目 信息 和 选择 技术 


v E? ch5 2 2 
v (58 src/main/Java 
v £8 com.wisely.ch5 2 2 
> [f] Ch522Applicationjava 


ES src/main/resources 


(8 src/test/java 

mA JRE System Library [JavaSE-1.8] 
> BA Maven Dependencies 
> & src 

& target 

im] pom.xml 


图 5-8 项目 结构 


(4) 依赖 树 如 图 5-9 所 示 。 


Dependency Hierarchy | |&, o0 


v (5 spring-boot-starter : 1.3.0.M1 [compile] 
> (3 spring-boot : 1.3.0.M1 [compile] 
> © spring-boot-autoconfigure : 1.3.0.M1 [compile] 
> ©) spring-boot-starter-logging : 1.3.0.M1 [compile] 
Cj spring-core : 4.2.0.RC1 (omitted for conflict with 4.2.0.RC1) [1 
G snakeyaml : 1.15 [compile] 
> ©) spring-boot-starter-tomcat : 1.3.0.M1 [compile] 
(3 spring-boot-starter-validation : 1.3.0.M1 [compile] 
G jackson-databind : 2.5.4 [compile] 
(3 spring-web : 4.2.0.RC1 [compile] 
G spring-webmwvc : 4.2.0.RC1 [compile] 
spring-boot-starter-test : 1.3.0.M1 [test] 
C) junit : 4.12 [test] 


C) hamcrest-core : 1.3 (omitted for conflict with 1.3) [test] 


C) mockito-core : 1.10.19 [test] 


o hamcrest-core : 1.3 (managed from 1.1) (omitted for conflici 
C) objenesis : 2.1 [test] 
Ó hamcrest-core : 1.3 [test] 
C) hamcrest-library : 1.3 [test] 
C) hamcrest-core : 1.3 (omitted for conflict with 1.3) [test] 
G spring-core : 4.2.0.RC1 [compile] 
© spring-test : 4.2.0.RC1 [test] 
C) spring-core : 4.2.0.RC1 (omitted for conflict with 4.2.0.RC1) [i 


图 5-9 依赖 树 


5.2.3 IntelliJ IDEA 


IntelliJ IDEA 是 我 比较 推 尝 的 开发 工具 ， 对 新 
技术 有 第 一 时 间 的 支持 ， 使 用 IntelliJ IDEA 14.1 版 


本 可 直接 新 建 Spring Boot 项 目 。 


(1) 新 建 Spring Initializr 项 目 ， 如 图 5-10 所 
S 


图 5-10 “新建 Spring Initializr 项 目 


(2) 填写 项 目 信息 ， 如 图 5-11 所 示 。 


Jl New Project x 


图 5-11 填写 项 目 信息 
(3) 选择 项 目 使 用 技术 ， 如 图 5-12 所 示 。 


DI New Project x 


图 5-12 ”选择 项 目 使 用 技术 
(4) 填写 项 目 名 称 ， 如 图 5-13 所 示 。 


引 New Project x 


图 5-13 ”填写 项 目 名 称 


|. (5) 将 项 目 设置 为 Maven 项 目 ， 如 图 5-14 所 
7e 


™ Non-managed pom.xml file found: 
™ :\Workspaces\workspace- r\chS_2 


rkspace-career\chS_2 3\pom.xmi 


图 5-14 ”设置 为 Maven 项 目 
(6) 项 目 结 构 及 依赖 树 如 图 5-15 所 示 。 


图 5-15 项目 结构 及 依赖 树 


5.2.4 Spring Boot CLI 

Spring Boot CLI Spring Boot 提 供 的 控制 台 命 
LR 

1. FEX Spring Boot CLI 

Spring Boot 1.3.0.M1 的 下 载 地 址 是 : 


http://repo.spring.io/release/org/springframewor 
k/boot/spring-boot-cli/1.3.0.RELEASE/spring-boot- 
cli-1.3.0.RELEASE-bin.zip 


2. 解 压 并 配置 到 环境 变量 
解压 后 将 CLI 的 bin 目 也 深 加 a 到 环境 变量 的 Path 


中 ， 这 样 我 们 就 可 以 在 控制 台 直 接 调 用 Spring 
Boot CLIS ， 如 图 5-16 所 示 。 


wisely JAP ÆU) 


变量 值 


| 


27\Scripts;C:\OpenBR-0.5.0-win64\bin;C:\Program Files\nodejs :D:\spring-1.3.0.M1\bir| 


C:\ProgramData\Oracle\Java\javapath;C... 


-COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.... 
PROCESSOR_AR... AMD64 


Path 
PATHEXT 


REW)... 编辑 中 ... 删除 (LD 


确定 取消 


图 5-16 ”将 bin 目 录 添 加 到 环境 变量 的 Path 中 


3. 使 用 命令 初始 化 项 目 


要 想 实 现 上 面 儿 个 例子 的 效果 ， 需 在 控制 台 
输入 以 下 命令 : 


spring init --build=maven --java-version-1.8 -- 
dependencies-web --packaging-jar --boot-version=1.3.0.M1 -- 
groupId-com.wisely  --artifactId-ch5 2 4 


一 人 


运行 效果 如 图 5-17 所 示 。 


spring init --build=maven --java-version-1l.8 --dependencies-web --pa 


.0. M1 --groupId=com wisely  --artifactId-chb 2 4 


4. 项 目 结构 
从 图 5-18 同 样 可 以 看 出 这 是 一 个 普通 的 Maven 
项 目 。 


B ch5_2 4.zip - 360 压 缩 3.2 正 式 版 


| we 

& aag 
添加 解 讨 到 Be 删除 

4} => BB ch5_ 2 4zip - 解 包 大 小 为 3.0 KB 


P. CERE) 
H sre 文件 去 
2.2 KB 1 KB XML 文件 


Jpom.xml 


图 5-18 项目 结构 


5.2.5 “Maven 手 工 构建 


前 面 我 讲述 了 用 不 同 的 方式 构建 Spring Boot 
项 目 ， 但 事实 上 建立 的 只 是 一 个 Maven 项 目 ， 如 
果 不 借 助 上 面 的 方式 ， 我 们 应 如 何 构建 Spring 
Boot™ AYE? 


1.Maven 项 目 构 建 


我 们 可 以 用 任意 开发 工具 新 建 空 的 Maven 项 
目 ， 在 1.2 广 已 经 做 了 较为 详细 的 讲解 。 


2. 修 改 pom.xml 


(1) 添加 Spring Boot 的 父 级 依赖 ， 这 样 当前 
的 项 目 丈 是 Spring Booth H Y ° spring-boot-starter- 
parent 是 一 个 特殊 的 Starter , 它 用 来 提供 相 天 的 
Maven A AKiN, EHEZ., HEKRA] 
UE Eversiont az, XT Spring Boot 提 供 了 哪些 
jar 包 的 依赖 ， 可 查看 C: \Users\ 用 户 
\.m2\repository\org\springframework\boot\spring- 
boot-dependencies\1.3.0.M1\spring-boot- 
dependencies-1.3.0.M1.pom 文 件 中 的 声明 。 


<parent> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-parent</artifactId> 
<version>1.3.0.M1</version> 
<relativePath/> 

</parent> 


(2) 在 dependencies 添 加 Web 文 持 的 starter 
pom， 这 样 驶 添加 了 Web 的 依 顿 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 


</dependency> 
(3) 添加 Spring Boot 的 编译 插件 。 
<build> 
<plugins> 
<plugin> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven- 
plugin</artifactId> 
</plugin> 
</plugins> 
</build> 


(4) 因为 我 们 使 用 的 是 里 程 碑 版 的 Spring 
Boot， 寿 使 用 的 是 正式 版 则 不 需要 下 面 的 配置 。 


«repositories» 

«repository» 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.10/snapshot</url> 
<snapshots> 

<enabled>true</enabled> 

</snapshots> 

</repository> 

<repository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.i0/milestone</url> 
<snapshots> 


a2 


<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 
<pluginRepositories> 
<pluginRepository> 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.10/snapshot</ur1l> 
<snapshots> 
<enabled>true</enabled> 
</snapshots> 
</pluginRepository> 
<pluginRepository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.i0/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</pluginRepository> 
</pluginRepositories> 


简单 演示 


1.3815 Spring Boot 项 目 
使 用 上 述 方 法 新 建 Spring Boot 项 目 后 ， 生 成 


的 项 目的 根 包 目 好 下 会 有 有 一 个 
artifactId+Application 命 名 规则 的 入 口 类 。 如 图 5- 
19 所 示 。 


v Hj com.wisely.ch5 2 2 


|J] Ch522Applicationjava 


图 5-19 ”入 口 类 
2. 添 加 测试 控制 器 


为 了 种 示 傈 单 ， 我 们 不 再 新 建 控制 舌尖， 
年 直 接 在 入 口 类 中 编写 代码 。 


package com.wisely.ch5 2 2; 


import org.springframework.boot.SpringApplication; 
import 
org.springframework.boot.autoconfigure.SpringBootApplication 


T 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


QRestController 
QSpringBootApplication //1 
public class Ch522Application { 


QRequestMapping("/") 
String index() { 
return "Hello Spring Boot"; 


j 


public static void main(String[] args) { //2 
SpringApplication.run(Ch522Application.class, args); 


j 


代码 解释 
DO@SpringBootApplication 


@SpringBootApplication Spring Boot 项 目的 
核心 注解 ， 主 要 目的 是 开局 目 动 配置 。 我 们 将 在 
6.1.2 世 中 做 更 详细 的 讲解 。 

@main 方 法 

这 是 一 个 标准 的 Java 应 用 的 main 方 法 ， 主 要 
作用 是 作为 项 目 启动 的 入 口 。 我 们 将 在 6.1.1 广 做 
更 详细 的 讲解 。 

BITAR 

我 们 可 以 通过 Maven 命 令 ， 运 行 项 目 。 


mvn spring-boot:run 


BY FAT Ch522A pplication #, EA HSK h 
选择 以 Spring Boot APP 或 Java Application 运 行 项 
目 ， 如 图 5-20 所 示 。 


n sj 1 Run on Server Alt+Shift+X, R 
G1 2 Java Application Alt+Shift+X, J 
> || 3 Spring Boot App Alt+Shift+X, B 


Run As 

Validate 

Replace With 
@ GitHub è Run Configurations... 


图 5-20 “右键 荣 单 


访问 http:Wlocalhost: 8080， 结 果 如 图 5-21 所 
ZR? 


@ localhost:8080 x 


~ œŒ | D localhost:8080 


Hello Spring Boot 


图 5-21 运行 结果 


第 6 章 Spring Boot 核 心 


6.1 基本 配置 


6.1.1 入 口 类 和 @SpringBootApplication 


Spring Boot 通 常 有 一 个 名 为 *+Application 的 入 
品类 ， 入 口 类 里 有 一 个 main 方 法 ， 这 个 main 方 法 
其 实 束 是 一 个 标准 的 Java 应 用 的 入 口 方法 。 在 
main 方 法 中 使 用 SpringApplication.run 

(Ch522Application.class, args) ， 局 动 Spring 
Booty HMH ° 


@SpringBootApplication 是 Spring Boot 的 核心 
注解 ， 它 是 一 个 组 合 注 解 ， 源 码 如 下 : 


QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
QDocumented 

QInherited 

QConfiguration 

QEnableAutoConfiguration 

@ComponentScan 

public @interface SpringBootApplication { 


Class<?>[] exclude() default {}; 
String[] excludeName() default {}; 


@SpringBootApplication 注 解 主 要 组 合 了 
@Configuration ^ @EnableAutoConfiguration ^ 
@ComponentScan; ^H 
@SpringBootApplication 注 解 ， 则 可 以 在 入 口 类 上 
直接 使 用 @Configuration ^ 
@EnableAutoConfiguration ` @ComponentScan ° 


Rm, a 
Boot fit 8H FP BJjar BAKRA S BL H ETT H 
Bic 


例如 ， 漆 加 了 spring-boot-starter-web 依 赖 ， 会 
目 动 添加 Tomcat 和 Spring MVC 的 依赖 ， 那 么 
Spring Boot 会 对 Tomcat 和 Spring MVC 进 行 目 动 配 
He 


XJ, SH T spring-boot-starter-data-jpati 
WU. Spring Boot 会 目 动 进 行 JPA 相 天 的 配置 。 


Spring Boot 会 目 动 扫 摘 
@SpringBootApplication 所 在 类 的 同 级 包 (如 
com.wisely.ch5_2_2) 以 及 下 级 包 里 的 Bean (AA 
JPA 项 目 还 可 以 扫描 标注 @Entity 的 实体 类 ) o 


议 入 口 类 放置 的 位 置 在 groupId+arctifactID 组 合 的 
包 名 下 。 


6.1.2 天 闭 特 定 的 目 动 配置 


通过 上 面 的 @SpringBootApplication 的 源码 我 
们 可 以 看 出 ， 关 闭 竺 定 的 目 动 配置 应 该 使 用 
@SpringBootApplication 注 解 的 exclude 参 数 ， 例 
如 : 


QSpringBootApplication(exclude = 
{DataSourceAutoConfiguration.class}) 


6.1.3 ”定制 Banner 


1. 修 改 Banner 


(1) 在 Spring Boot 局 动 的 时 候 会 有 一 个 默认 
局 动 图 条 ， 如 图 6-1 所 示 。 


oo ower a F 

( C) | Ped | oc oe FD 

WT IOP EE EP tle )))) 
—4-—LILLILX 2.17777 

=========|_|==============|_ /=/ // / 

:: Spring Boot :: (v1.3.0.M1) 


图 6-1 默认 局 动 图 案 


(2) 我 们 在 src/main/resources 下 新 建 一 个 


banner.txt ° 


(3) 通过 http://patorjk.com/software/taag 网 站 
生成 字符 ， 如 敲 入 的 为 “WISELY”， 将 网 站 生成 
的 字符 复制 到 bannertxt 中 。 


(4) 这 时 再 启动 程序 ， 图 案 将 变 为 如 图 6-2 
ZR œ 


iHiiiiii'iHil IHHHEII  IHBHHHHE: : 'iHHHHHHHE : dE ttt: dH idt 
Site Hie Bc. Boi 4H... Fs) Mhaona ti eee. Be 
Bee Bas BEES WESS HESS. HEISE: 442172250554 HHG 
HH: tH: dHEII dHEPIDI. GHHHHHEPII GHHHHHEDII 4BDiiiiiiii. GHÉ 
Hits Hi: Hiss Boss www Hi: SS dHÉ 
ijr TS HRS SS ee RS BSS ees: AHipssssscsss GHE 
iHHt. iHHb:: HHH. SHBHHHHE:: ISHBHHHHHE: IHHHHHHHE HH 
2015-06-23 17:06:39.235 INFO 4936 --- [ main] com .wj 


Ke-2 ”改变 后 的 图 案 


2. 关 加 banner 


(1) main 里 的 内 容 修 改 为 : 


SpringApplication app = new 
SpringApplication(Ch522Application.class); 
app.setShowBanner(false); 

app.run(args); 


(2) 或 使 用 fluent API 修 改 为 : 


new SpringApplicationBuilder(Ch522Application.class) 
.showBanner(false) 
.run(args); 


6.1.4 Spring Boot 的 配置 文件 


Spring Boot 使 用 一 个 全 局 的 配置 文件 
application.properties 或 application.yml， 放 置 在 
src/main/resources H REKA AS E TH J/config F ° 


Spring Boot [X LFF% HLH propertiesHic Ei X 

件 ， 还 文 持 yaml 语 言 的 配置 文件 。yaml 是 以 数据 

zt 在 配置 数据 的 时 候 具 有 和 面 同 对 和 象 
J 特征 。 


Spring Boot 的 全 局 配置 文件 的 作用 是 对 一 些 
默认 配置 的 配置 值 进 行 修改 。 


1.18] ER zi hl 


将 Tomcat 的 默认 端口 号 8080 修 改 为 9090， 并 
将 默认 的 访问 路 径 “/” 修 改 为 “helloboot”。 


HJ EA X£application.properties FY: 


server.port-9090 
server.context-path-/helloboot 


BY TE application.yml FF 227: 


server: 
port: 9090 
contextPath: /helloboot 


从 上 面 的 配置 可 以 看 出 ， 在 Spring Boot, 
context-path、contextPath 或 者 CONTEXT_PATH 形 
式 其 实 是 通用 的 。 并 且 ，yaml 的 配置 更 简 汪 清 
iit HBISTS 3.7.0 已 开始 文 持 yaml 语 言 配置 ， 而 
IntelliJ IDEA 则 只 对 Spring BootH'Jproperties?i E fe 
供 了 目 动 提示 的 功能 ， 且 @PropertySource 注 解 也 
不 文 持 加 载 yaml 文 件 。 在 日 冲 开 发 中 ， 我 们 习惯 
于 用 properties 文 件 来 配置 ， 所 以 目前 推荐 使 用 
properties 进 行 配置 。 


在 附录 A.3 中 有 Spring Boot 常 用 配置 的 列表 。 


6.1.5 


starter pom 


Spring Boot 为 我 们 提供 了 痪 化 企业 级 开发 绝 
大 多 数 场 景 的 starter pom， 只 要 使 用 了 应 用 场景 所 
需要 的 starter pom， 相 关 的 技术 配置 将 会 消除 ， 整 
可 以 得 到 Spring Boot 为 我 们 提供 的 目 动 配置 的 


Bean ? 


1.'E/ 7] starter pom 


Spring Boot E 77 fet T JA13€6-1PT71H Jstarter 


pom ° 


36-1 


官方 提供 的 starter pom 


名 称 描 ” 述 
spring-boot-starter Spring Boot 核心 starter， 包 含 自 动 配置 、 日 志 、yaml 配 兽 文 件 的 支持 
spring-boot-starter-actuato 准 生 产 特性 ， 用 来 监控 和 管理 应 用 
spring-boot-st mote-shell 提供 基于 ssh 协议 的 监控 和 管理 
spring-boot-starter-amqp 使 用 spring-rabbit 来 支持 AMQP 
spring-boot-starter-aop 使 用 spring-aop 和 AspectJ 支持 面向 切面 编程 
spring-boot-st atch 对 Spring Batch 的 支持 
spring-boot-st: ache 对 Spring Cache 抽象 的 支持 
spring-boot-st ud-connectors | 对 云 平 台 (Cloud Foundry, Heroku ) 提供 的 服务 提供 简化 的 连接 方式 


名 R 
spring-boot-starter-data-elasticsearch 
spring-boot-starter-data- gemfire 
spring-boot-starter-data-jpa 
spring-boot-starter-data-mongodb 
spring-boot-starter-data-rest 
spring-boot-starter-data-solr 
spring-boot-starter-freemarker 
spring-boot-starter-groov y-templates 
spring-boot-starter-hateoas 
spring-boot-starter-hornetq 
spring-boot-starter-integration 
spring-boot-starter-jdbe 
spring-boot-starter-jersey 
spring-boot-starter-jta-atomikos 
spring-boot-starter-jta-bitronix 
spring-boot-starter-mail 
spring-boot-starter-mobile 


spring-boot-starter-mustache 


续 表 
fi 3x 


通过 spring-data-elasticsearch 对 Elasticsearch 支持 

通过 spring-data-gemfire 对 分 布 式 存储 GemFire 的 支持 

对 JPA 的 支持 ， 包 含 spring-data-jpa、 spring-orm 和 Hibernate 

通过 spring-data-mongodb, X} MongoDB 进行 支持 

通过 spring-data-rest-webmvc 将 Spring Data repository 暴露 为 REST 形式 的 服务 
通过 spring-data-solr 对 Apache Solr 数据 检索 平台 的 支持 

对 FreeMarker 模板 引擎 的 支持 

对 Groovy 模板 引擎 的 支持 

通过 spring-hateoas 对 基于 HATEOAS 的 REST 形式 的 网 络 服务 的 支持 
通过 HornetQ 对 JMS 的 支持 

对 系统 集成 框架 spring-integration 的 支持 

对 JDBC 数据 库 的 支持 

对 Jersery REST 形式 的 网 络 服务 的 支持 

通过 Atomikos 对 分 布 式 事务 的 支持 

通过 Bitronix 对 分 布 式 事务 的 支持 

对 javax.mail 的 支持 

对 spring-mobile 的 支持 

对 Mustache 模板 引 称 的 支持 


spring-boot-starter-redis 
spring-boot-starter-security 
spring-boot-starter-social-facebook 
spring-boot-starter-social-linkedin 
spring-boot-starter-social-twitter 
spring-boot-starter-test 
spring-boot-starter-thymeleaf 
spring-boot-starter-velocity 
spring-boot-starter-web 
spring-boot-starter-Tomcat 
spring-boot-starter-Jetty 
spring-boot-starter-undertow 
spring-boot-starter-logging 
spring-boot-starter-log4j 
spring-boot-starter-websocket 


spring-boot-starter-ws 


对 键 值 对 内 存 数 据 库 Redis 的 支持 ， 包 含 spring-redis 

对 spring-security 的 支持 

通过 spring-social-facebook 对 Facebook 的 支持 

通过 spring-social-linkedin 对 Linkedin 的 支持 

通过 spring-social-twitter 对 Twitter 的 支持 

对 常用 的 测试 框架 JUnit, Hamcrest 和 Mockito 的 支持 ， 包 含 spring-test 模块 
对 Thymeleaf 模板 引擎 的 支持 ， 包 含 于 Spring 整合 的 配置 
对 Velocity 模板 引擎 的 支持 

对 Web 项 目 开 发 的 支持 ， 包 含 Tomecat 和 spring-webmve 
Spring Boot Shi Servlet 容器 Tomcat 

使 用 Jetty 作为 Servlet AHEHE Tomcat 

使 用 Undertow 作为 Servlet 容器 替换 Tomcat 

Spring Boot 默认 的 日 志 框 架 Logback 

支持 使 用 Logs 日 志 框架 

对 WebSocket 开发 的 支持 

对 Spring Web Services 的 支持 


2. 第 三 方 starter pom 


ER EJ H'Jstarter pom 外 ， 还 有 第 三 方 为 Spring 
Boot 所 写 的 starter pom， 如 表 6-2 所 示 。 


表 6-2 ”第 三 方 所 写 的 starter pom 


名 称 地 址 


Handlebars https://github.com/allegro/handlebars-spring-boot-starter 

Vaadin https://github.com/vaadin/spring/tree/master/vaadin-spring-boot-starter 
Apache Camel https://github.com/apache/camel/tree/master/components/camel-spring-boot 
WRO4J https://github.com/sbuettner/spring-boot-autoconfigure-wro4j 


Spring Batch ( 高 级 用 | https://github.com/codecentric/spring-boot-starter-batch-web 


ik) 


HDIV https://github.com/hdiv/spring-boot-starter-hdiv 


Jade Templates ( Jade4J ) | https://github.com/domix/spring-boot-starter-jade4j 


Actitivi https://github.com/Activiti/Activiti/tree/master/modules/activiti-spring-boot/spring-boot-starters 


6.1.6 ”使 用 xml 配 置 


Spring Boot 近 倡 雯 配置 ， 即 无 xml 配 置 ， 但 是 
在 实际 项 目 中 ， 可 能 有 一 些 特殊 要 求 你 必须 使 用 
xml 配 置 ， 这 时 我 们 可 以 通过 Spring 提供 的 
@ImportResource 来 加 载 xm] 配 置 ， 例 如 : 


@ImportResource({"classpath: some- 
context.xml", "classpath: another-context.xml"}) 


62 ”外 部 配置 


Spring Boot 人 允许 使 用 properties 文 件 、yaml 文 
件 或 者 命令 行 参数 作为 外 部 配置 。 


Spring Boot 可 以 是 基于 jar 包 运行 的 ， 打 成 jar 
包 的 程序 可 以 直接 通过 下 面 命令 运行 : 


java -jar xx.jar 


uf DoH PB], Pag S E EX Tomcat? O : 


java -jar xx.jar --server.port-9090 


6.2.2 ”常规 属性 配置 


在 2.2 廊 我 们 讲述 了 在 常规 Spring 环 境 下 ， 注 
入 properties 文 件 里 的 值 的 方式 ， 通 过 
@PropertySource 指 明 properties 文 件 的 位 置 ， 然 后 


通过 @Value 注 入 值 。 在 Spring Boot 里 ， 我 们 只 需 
在 application.properties 定 义 属性 ， 直 接合 用 
(9 Valuei A BB n] « 


1.3 y, 
在 上 例 的 基础 上 ， 进 行 如 下 的 修改 。 


(1) application.properties 增 加 属性 : 


book .author=wangyunfei 
book.name 


-spring boot 


(2) 修改 入 口 类 : 


package com.wisely.ch5_2 2; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplicatio 
n; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


QRestController 
QSpringBootApplication 
public class Ch522Application { 


QValue("$(book.authorj") 
private String bookAuthor; 
@Value("${book.name}") 


private String bookName; 


QRequestMapping("/") 
String index() { 

return "book name is:"+bookName+" and book 
author is:" + bookAuthor; 


public static void main(String[] args) { 
SpringApplication.run(Ch522Application.class, 
args); 


j 


(3) 3511, WilHlhttp://localhost: 
9090hellobooVy， 歼 果 如 图 6-3 所 示 。 


localhost:9090/hellobo- x 


€ C& | D localhost:9090/helloboot, 


book name isispring boot and book author is:wangyunfel 


图 6-3 ”运行 效果 
6.2.3 ”类 型 安全 的 配置 (XT properties) 


上 例 中 使 用 @Value 注 入 每 个 配置 在 实际 项 目 
中 会 显得 格外 麻烦 ， 因 为 我 们 的 配置 通 各 会 是 许 
多 个 ， 厂 使 用 上 例 的 方式 则 要 使 用 @Value 注 入 很 


多 次 。 


_ Spring Boot 下 提供 了 基于 类 型 安全 的 配置 方 
式 ， 通 过 @ConfigurationProperties 将 properties 属 
EE. NR 从 而 实现 类 型 安全 
JILE. ° 


1. 实 战 


(1) 新 建 Spring Boot 项 目 ， 如 图 6-4 所 示 。 


Maven Project v 
Java Versiow 18 
— 
Group com.wisely 
Avtitact ch6_2 3 
Version 0.0.1-SNAPSHOT 
Desciption — Demo project for Spring Boot 


com wisely.ch6 2 3 
口 AMQP AWS AWS JDBC 
_ Apache Derby L AMomakos UTA) 
L_j Batch | s |j Cache Cloud Bootstrap 
Cloud Bus AMQP Cloud Security Config Cent 


AVES Messaging 


Contig Server 
Eureka Server 
C) Germfire 


Oe " $ 


Fmqn 
Dn 


Eureka 


HSQiDG Hystrix Dashboard imegration 
a j08C | [1 ij Jersey UAX-RS) 
| PostgreSQL 
Ribbon 


Turbine 


Turbine AMQP ' l] Velocity 
[ws ; ] Zul 


图 6-4 新 建 Spring Boot 项 目 


(2) 添加 配置 ， 即 在 application.properties 上 
添加 : 


author .name=wyf 
author.age 


=32 


MR, RITE n] ASE — T properties X: fF , 

DE mit @ConfigurationProperties 上 的 属性 

iocations 里 指定 properties 的 位 置 且 需 要 在 入 口 
关上 配置 。 


(3) 类 型 安全 的 Bean， 代 人 码 如 下 : 


package com.wisely.ch6 2 3.config; 


import 
org.springframework.boot.context.properties.ConfigurationPr 
operties; 

@Component 

@ConfigurationProperties(prefix = "author") //1 


public class AuthorSettings { 
private String name; 
private Long age; 


public String getName() { 
return name; 


j 


public void setName(String name) { 
this.name - name; 


j 


public Long getAge() { 
return age; 


j 


public void setAge(Long age) { 
this.age - age; 


代码 解释 


(通过 @ConfigurationProperties 加 载 properties 
文件 内 的 配置 ， 通 过 prefix 属 性 指定 properties 的 配 
置 的 前 缀 ， 通 过 locations 指 定 properties 文 件 的 位 
m. Bin. 


@ConfigurationProperties(prefix = "author",locations = 
("classpath:config/author.properties")) 


本 例 不 需要 配置 locations。 
(4) 检验 代码 : 


package com.wisely.ch6 2 3; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplicatio 
n; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.ch6 2 S3.config.AuthorSettings; 
QRestController 

QSpringBootApplication 

public class Ch623Application { 


QAutowired 
private AuthorSettings authorSettings; //1 


QRequestMapping("/") 
public String index(){ 
return "author name is "+ 
authorSettings.getName()+" and author age is 
"rauthorSettings.getAge(); 
} 


public static void main(String[] args) { 
SpringApplication.run(Ch623Application.class, 
args); 


) 
) 
代码 解释 
(可 以 用 @Autowired 直 接 注 入 该 配置 。 


(5) 运行 ， 访 问 : http://localhost: 8080/, 
效果 如 图 6-5 所 示 。 


@ localhost:8080 x 


= '€MllillIocalhost:8080 


author name is wyf and author age is 32 


图 6-5 ”运行 效果 


63 HME 


Spring Boot 支 持 Java Util Logging ` Log4J ^ 
Log4J2 和 Logback 作 为 日 志 框 架 ， 无 论 使 用 哪 种 日 
EAS, Spring Boot E A BI eA H EZRA 
制 台 输 出 及 文件 输出 做 好 了 配置 ， 可 对 比 4.2.2 市 
中 没有 Spring Boot 时 日 志 配 置 的 方式 。 


默认 lav P, Spring Boot 使 用 Logback 作 为 日 


配置 日 志 级 列 : 


logging.file-D:/mylog 


/log.log 


配置 日 志文 件 ， 格 式 为 logging.level. 包 名 = 级 


Al): 


logging.level.org.springframework.web= DEBUG 


6.4 ”Profile 配置 


Profile 是 Spring 用 来 针对 不 同 的 环境 对 不 同 的 
配置 提供 文 持 的 ， 全 局 Profile 配 置 使 用 application- 
{profile}.properties (Zllapplication- 
prod.properties) 


38 3x TE application.properties FF ix €. 
Spring.profiles.active=prod 来 指定 活动 的 Profile ° 


下 面 将 做 一 个 最 简单 的 演示 ， 如 我 们 分 为 生 
J^ (prod) 和 开发 (dev) 环境 ， 生 产 环 境 下 端口 
号 为 80， 开 发 环境 下 端口 为 8888 。 
实战 


(1) 新 建 Spring Boot 项 目 ， 如 图 6-6 所 示 。 


New Spring Starter Project 


Name 


Type: Maven Project v 


Java Version: 


Boot Version: 


Group com.wisely 


Artifact ch6 4 


Version 0.0.1-SNAPSHOT 


Description Demo project for Spring Boot 


com.wisely.ch6 4 
Dependencies 
J AMQP 
AWS Messaging 


Package 


[ ]AOP 
[C] Actuator 


AWS 
[_] Apache Derby 


AWS JDBC 
[ ]Atomikos (JTA) 


[C] Batch 

Cloud Bus AMQP 
Config Server 
Eureka Server 
Gemfire 
HSQLDB 

JDBC 

LinkedIn 
Mustache 

Redis 


mmumum3u 


f 
H 


Turbine AMQP 


[C] Bitronix UTA) 

C] Cloud Connectors 
[ ]DevTools 

| ]Facebook 


Hystrix 
[.]JMS 

[C] Mail 

C] MySQL 

[_] Remote Shell 
| ]Solr 

[ ] Twitter 


C] Groovy Templates 


| |Cache 

Cloud Security 
[ ]Elasticsearch 
Feign 


[]H2 


[JPA 
[C] Mobile 
OAuth2 
| ]Rest Repositories 
[ ] Thymeleaf 
[_] Vaadin 


Hystrix Dashboard 


Cloud Bootstrap 
Config Client 
Eureka 

[ ] Freemarker 

[ ]HATEOAS 

[Integration 

[_] Jersey (JAX-RS) 

[ ]MongoDB 

[ ]PostgreSQL 
Ribbon 


Turbine 


[ ] Velocity 


[ ]Websocket Zuul 


图 6-6 ”新建 Spring Boot H 
(2) 生产 和 开发 环境 下 的 配置 文件 如 下 : 


application-prod.properties: 


server.port-80 


application-dev.properties: 


server.port-8888 
此 时 目 邓 结构 如 图 6-7 所 示 。 


v fj com.wisely.ch6 4 
v (58 src/main/resources 
C= static 
(= templates 


application-dev.properties 
application-prod.properties 
f£? application.properties 


图 6-7 目录 结构 
(3) 运行 。 
application.properties 增 加 : 


spring.profiles.active=dev 


局 动 程 序 结果 为 : 


Registering beans for JMX exposure on startup 


Tomcat started on port(s):|8888 |(http) 
Started Ch64Application in 2.403 seconds (JVM running for 2.755) 


修改 application.properties: 


spring.profiles.active-prod 


6.5 Spring Boot 运 行 原 理 


在 前 面 几 个 草 广 ， 我 们 见识 了 Spring Boot 为 
我 们 做 的 目 动 配置 ， 为 了 让 大 家 快速 领略 Spring 
Boot 的 兵力 ， 我 们 将 在 本 广 完 通过 分 析 Spring 
Boot 的 运行 原理 后 ， 根 据 已 掌握 的 知识 目 定 义 一 


个 starter pom ° 


在 3.5 革 中 我 们 了 解 到 Spring 4.x 提 供 了 基于 条 
件 来 配置 Bean 的 能 力 ， 其 实 Spring Boot 的 神奇 的 
实现 也 是 基于 这 一 原理 的 。 


本 和 虽然 没有 摆 在 书 的 显著 位 置 ， 但 是 本 
的 内 容 是 理解 Spring Boot 运 作 原 理 的 天 键 。 我 们 
可 以 依 助 这 一 特性 来 理解 Spring Boot 运 行 目 动 配 
置 的 原理 ， 并 实现 目 己 的 目 动 配置 。 


Spring Boot 天 于 日 动 配置 的 源码 在 spring- 
boot-autoconfigure-1.3.0.x.jar 内 ， 主 要 包含 如 
6-8 所 示 的 配置 。 


v &B org.springframework.boot.autoconfigure 
^ & admin 
^ Œ amap 
^ Œ aop 
> £8 batch 
H3 cache 
> $8 cloud 
> 88 condition 
| £8 dao 
> $8 data 
§ elasticsearch 
^ 出 flyway 
» 出 freemarker 
> £8 groovy.template 
> Œ gson 
^ 册 hateoas 
| &B integration 
£8 jackson 
”出 jdbc 
Bi jersey 
8i jms 
^O BH jmx 
> £8 liquibase 
> Œ logging 
> B mail 
H3 mobile 
^ £8 mongo 
> {8 mustache 
> & ormjpa 
tB. reactor ^ 8j template 
> 出 redis > 8j thymeleaf 
^ Bj security > Bj transaction 
^ £8 sendgrid > Œ velocity 
> £8 social > 8 web 
^ &B solr ^ Œ websocket 


图 6-8 包含 的 配置 


右 想 知道 Spring Boot 为 我 们 做 了 哪些 目 动 配 
E, URA X HEIR ° 


可 以 通过 下 面 三 种 方式 得 看 当前 项 目 中 已 局 
用 和 未 局 用 的 目 动 配置 的 报 香 。 


(1) 运行 jar 时 增加 --debug 参 数 : 
Java -jar xx.jar --debug 


(2) 在 application.properties 中 设置 属性 : 


debug=true 


(3) 在 STS 中 设置 ， 如 图 6-9 所 示 。 


ni SEAS 
1 Ch64Application 

2 Ch522Application 

3 Ch623Application 

4 ch5_2_2 - Ch522Application 

5 Pivotal tc Server Developer Edition v3.1 
6 ProcessTestLaptopHumanProcess 


Run As 


Organize Favorites... 


Name: | Ché4Application 
(© Main |= Arguments \ BA JRE | 2ọ Classpath | Ey Source | m Environment E Common | 
Program arguments: A 
Variables... 
VM arguments: 
-Ddebug A | 
| Variables... | 
Working directory: 
@ Default: ${workspace_loc:ch6_4} 
© Other: 
Workspace... File System... Variables... 
v 
Apply Revert 


图 6-9 在 STS 中 设置 


此 时 启动， 可 在 控制 台 输出 。 已 局 用 的 目 动 
MEN: 


AUTO-CONFIGURATION REPORT 


Positive matches: 


DispatcherServletAutoConfiguration 
- @ConditionalOnClass classes found: org.springframework.web.servlet.DispatcherServlet (OnClassCondition) 
- found web application StandardServletEnvironment (OnWebApplicationCondition) 
DispatcherServletAutoConfiguration.DispatcherServletConfiguration 
- @ConditionalOnClass classes found: javax.servlet.ServletRegistration (OnClassCondition) 
- no ServletRegistrationBean found (DispatcherServletAutoConfiguration.DefaultDispatcherServletCondition) 


EmbeddedServletContainerAutoConfiguration 
- found web application StandardServlettnvironment (OnWebApplicationCondition) 


末 局 用 的 目 动 配置 为 : 


Negative matches: 


ActiveMQAutoConfiguration 
- required @ConditionalOnClass classes not found: javax.jms.ConnectionFactory,org.apache.activemq.ActiveMQCo 


AopAutoConfiguration 
- required (KonditionalOnClass classes not found: org.aspectj.lang.annotation.Aspect,org.aspectj.lang.reflec 


BatchAutoConfiguration 
- required @ConditionalOnClass classes not found: org.springframework.batch.core.launch.JobLauncher,org.spri 


CacheAutoConfiguration 
- @ConditionalOnClass classes found: org.springframework.cache.CacheManager (OnClassCondition) 
- @ConditionalOnBean (types: org.springframework.cache.interceptor.CacheAspectSupport; SearchStrategy: all) 


6.5.1 运作 原理 


KT Spring Boot 的 运作 原理 ， 我 们 还 是 回归 
到 @SpringBootApplication 注 解 上 来 ， 这 个 注解 是 
一 个 组 合 注 解 ， 它 的 核心 功能 是 
(@EnableAutoConfiguration 注 解 提 供 的 。 


下 面 我 们 来 看 下 @EnableAutoConfiguration 注 
解 的 源码 : 


QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
QDocumented 
QInherited 
@Import({ EnableAutoConfigurationImportSelector.class, 
AutoConfigurationPackages.Registrar.class }) 

public Qinterface EnableAutoConfiguration { 

Class<?>[] exclude() default {}; 

String[] excludeName() default {}; 


这 里 的 关键 功能 是 @Import 注 解 导 入 的 配置 功 
能 ，EnableAutoConfigurationImportSelector 人 更 用 
SpringFactoriesLoaderloadFactoryNames 方 法 来 扫 
摘 具 有 META-INEF/spring.factories 文 件 的 jar 包 ， 而 
Fíl ]HJspring-boot-autoconfigure-1.3.0.x.jar E W6 
一 个 Spring.factories 文 件 ， 此 文件 中 声明 了 有 哪些 
目 动 配置 ， 如 图 6-10 所 示 。 


B spring.factories 25 
1# Initializers 
2 org. springframework.context.ApplicationContextInitializer=\ 

3 org. springframework. boot .autoconfigure. logging.AutoConfigurationReportLoggingInitializer 
5|& Auto Configure 
5 org.springframework.boot.autoconfigure.EnableAutoConfiguration-V 
7 org. springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,V 
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,V 
) org. springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,V 
19 org. springframework.boot.autoconfigure.MessageSourceAutoConfiguration,V 
11 org.springframework.boot.autoconfigure.PropertyPlaceholderAutoConfiguration,N 
2 org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration,V 

13 org. springframework. boot. autoconfigure.cache.CacheAutoConfiguration, \| 

14 org. springframework. boot .autoconfigure.cloud.CloudAutoConfiguration, \ 

15 org. springframework.boot.autoconfigure.dao.PersistenceExceptionTranslationAutoConfiguration, \ 

6 org.springframework.boot.autoconfigure.data.elasticsearch.ElasticsearchRepositoriesAutoConfiguration, \ 

17 org. springframework. boot. autoconfigure.data.jpa.JpaRepositoriesAutoConfiguration, \ 

18 org. springframework. boot. autoconfigure.data.mongo.MongoRepositoriesAutoConfiguration, \ 

19 org. springframework. boot .autoconfigure.data.solr.SolrRepositoriesAutoConfiguration, \ 

20 org. springframework. boot . autoconfigure.data.rest.RepositoryRestMvcAutoConfiguration, \ 

21 org. springframework. boot .autoconfigure.data.web.SpringDataWebAutoConfiguration, \ 

22 org. springframework. boot .autoconfigure.freemarker . FreeMarkerAutoConfiguration, \ 

23 org. springframework. boot . autoconfigure.gson.GsonAutoConfiguration, \ 

24 org. springframework. boot .autoconfigure.hateoas.HypermediaAutoConfiguration, \ 

25 org. springframework. boot .autoconfigure. integration. IntegrationAutoConfiguration, \ 
org.springframework. boot .autoconfigure. jackson. JacksonAutoConfiguration, \ 
org.springframework.boot.autoconfigure. jdbc .DataSourceAutoConfiguration, V 

28 org. springframework.boot.autoconfigure. jdbc. IndiDataSourceAutoConfiguration, \ 

29 org. springframework.boot.autoconfigure. jdbc .xXADataSourceAutoConfiguration, \ 

30 org. springframework. boot. autoconfigure. jdbc .DataSourceTransactionManagerAutoConfiguration, \ 

1 org. springframework.boot.autoconfigure. jms. JmsAutoConfiguration, V 

32 org. springframework.boot.autoconfigure. jmx. JmxAutoConfiguration, \ 

3 org. springframework.boot.autoconfigure. jms. IndiConnectionFactoryAutoConfiguration, \ 


+ 


图 6-10 ”自动 配置 
6.5.2 ”核心 注解 


打开 上 面 任意 一 个 AutoConfiguration 文 件 ， 一 
艇 都 有 下 面 的 条 件 注解 ， 在 spring-boot- 
autoconfigure-1.3.0.x.jar 的 
org.Springframwork.boot.autoconfigure.condition 包 


下 ， 条 件 注解 如 下 。 


@ConditionalOnBean: 当 容 大 里 有 指定 的 
BeanBJ2&fr F ° 


@ConditionalOnClass: 当 类 路 径 下 有 指定 的 
类 的 条 件 下 。 


@ConditionalOnExpression: 基于 SpEL 表 达 式 
作为 判断 条 件 。 


@ConditionalOnJava: 基于 JVM 版 本 作为 判断 
条 件 。 


@ConditionalOnJndi: 在 JNDI 存 在 的 条 件 下 但 
找 指定 的 位 置 。 


@ConditionalOnMissingBean: “Aas EA 
指定 Bean 的 情况 下 。 


@ConditionalOnMissingClass: 当 类 路 径 下 没 
有 指定 的 类 的 条 件 下 。 


@ConditionalOnNotWebApplication: 当前 项 
目 不 是 Web 项 目的 条 件 下 。 


@ConditionalOnProperty: 指定 的 属性 是 人 否 有 
指定 的 值 。 


@ConditionalOnResource: 类 路 径 是 否 有 指定 
的 值 。 


@ConditionalOnSingleCandidate: 当 指 是 Bean 
在 容 磺 中 只 有 一 个 ， 或 者 虽然 有 多 个 但 是 指定 首 
和 达 的 Bean。 


@ConditionalOnWebApplication: 当前 项 目 是 
Web 项 目的 条 件 下 。 


这 些 注 解 都 是 组 合 了 @Conditional 元 注解 ， 只 
是 使 用 了 不 同 的 条 件 (Condition) ， 我 们 在 3.5 节 
已 做 过 阐述 定义 一 个 根据 条 件 创 建 不 同 Bean 的 演 
可 


下 面 我 们 用 在 3.5 节 学 过 的 知识 简单 分 析 一 下 
@ConditionalOnWebApplication 注 解 。 


package org.springframework.boot.autoconfigure.condition; 


import java.lang.annotation.Documented; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation.Target; 


import org.springframework.context.annotation.Conditional; 
@Target({ ElementType.TYPE, ElementType.METHOD }) 
QRetention(RetentionPolicy.RUNTIME) 

@Documented 

QConditional(OnWebApplicationCondition.class) 

public Qinterface ConditionalOnWebApplication { 


j 


从 源码 可 以 看 出 ， 此 注解 使 用 的 条 件 是 
OnWebApplicationCondition， 下 面 我 们 看 看 这 个 
条 件 是 如 何 构 所 的 : 


package org.springframework.boot.autoconfigure.condition; 


import org.springframework.context.annotation.Condition; 
import 
org.springframework.context.annotation.ConditionContext; 
import org.springframework.core.Ordered; 

import org.springframework.core.annotation.Order; 

import org.springframework.core.type.AnnotatedTypeMetadata; 
import org.springframework.util.ClassUtils; 

import org.springframework.util.ObjectUtils; 

import 
org.springframework.web.context.WebApplicationContext; 
import 
org.springframework.web.context.support.StandardServletEnvir 
onment; 


QOrder(Ordered.HIGHEST PRECEDENCE + 20) 
class OnWebApplicationCondition extends SpringBootCondition 


{ 


private static final String WEB_CONTEXT_CLASS = 
"org.springframework.web.context." 
+ "support.GenericwebApplicationContext"; 


QOverride 
public ConditionOutcome getMatchOutcome(ConditionContext 
context, 
AnnotatedTypeMetadata metadata) { 
boolean webApplicationRequired - metadata 


.isAnnotated(ConditionalOnWwebApplication.class.getName()); 
ConditionOutcome webApplication - 
isWebApplication(context, metadata); 


if (webApplicationRequired && 
!webApplication.isMatch()) { 
return 
ConditionOutcome.noMatch(webApplication.getMessage()); 


j 


if (!webApplicationRequired && 
webApplication.isMatch()) { 
return 
ConditionOutcome.noMatch(webApplication.getMessage()); 


} 


return 
ConditionOutcome.match(webApplication.getMessage()); 


j 


private ConditionOutcome 
isWebApplication(ConditionContext context, 
AnnotatedTypeMetadata metadata) { 


if (!ClassUtils.isPresent(WEB CONTEXT CLASS, 
context.getClassLoader())) { 
return ConditionOutcome.noMatch("web application 
classes not found"); 


j 


if (context.getBeanFactory() !- null) ( 


String[] scopes = 
context.getBeanFactory().getRegisteredScopeNames(); 

if (ObjectUtils.containsElement(scopes, 
"session")) ( 

return ConditionOutcome.match("found web 

application 'session' scope"); 

} 

} 


if (context.getEnvironment() instanceof 
StandardServletEnvironment) { 
return ConditionOutcome 
.match( "found web application 
StandardServletEnvironment"); 


j 


if (context.getResourceLoader() instanceof 
WebApplicationContext) { 
return ConditionOutcome.match("found web 
application WebApplicationContext"); 


return ConditionOutcome.noMatch("not a web 
application"); 


从 isWebApplication 方 法 可 以 看 出 ， 判 断 条 件 


H 
JE: 


(1) GenericWebApplicationContext 是 否 在 类 
路 径 中 


(2) iss HET Jsessionfi)scope; 


(3) 当前 容器 的 Enviroment 是 否 为 
StandardServletEnvironment; 


(4) 当前 的 ResourceLoader 是 否 为 
WebApplicationContext (ResourceLoader 是 
ApplicationContext 的 顶级 接口 之 一 ) ，; 


(5) 我 们 需要 构造 ConditionOutcome 类 的 对 
象 来 帮助 我 们 ， 最 终 通 过 
ConditionOutcome.isMatch 方 法 返回 布尔 值 来 确定 
条 件 。 


6.5.3 SEAT 


在 了 解 了 Spring Boot 的 运作 原理 和 主要 的 条 
件 注 解 后 ， 现 在 来 分 析 一 个 人 简单 的 Spring Boot 内 
置 的 自动 配置 功能 ，http 的 编码 配置 。 


我 们 在 常规 项 目 中 配置 http 编 码 的 时 候 是 在 
web.xml 里 配置 一 个 filter， 如 : 


<filter> 
<filter-name>encodingFilter</filter-name> 
<filter- 
class»org.springframework.web.filter.CharacterEncodingFilter 
«/filter-class» 
<init -param> 
<param-name>encoding</param-name> 
<param-value>UTF -8</param-value> 
«/init-param» 
<init -param> 
<param-name>forceEncoding</param- name> 
<param-value>true</param-value> 


«/init-param» 
</filter> 


目 动 配置 要 满足 两 个 条 件 : 


(1) 能 配置 CharacterEncodingFilter 这 个 
Bean; 


(2) 能 配置 encoding 和 forceEncoding 这 两 个 


1. 配 置 参 数 


在 6.2.3 廊 我 们 讲述 了 类 型 安全 的 配置 ，Spring 
Boot 的 目 动 配置 也 是 基于 这 一 点 实现 时 ， 这 里 的 
配置 类 可 以 在 application.properties 中 直接 设置 ， 源 
ASU P: 


@ConfigurationProperties(prefix = "spring.http.encoding")//1 
public class HttpEncodingProperties { 


public static final Charset DEFAULT CHARSET - 
Charset.forName("UTF-8");//2 


private Charset charset - DEFAULT CHARSET; //2 
private boolean force - true; //3 
public Charset getCharset() { 


return this.charset; 


public void setCharset(Charset charset) { 
this.charset = charset; 


j 


public boolean isForce() { 
return this.force; 
} 


public void setForce(boolean force) { 
this.force = force; 


} 


代码 解释 


在 application.properties 配 置 的 时 候 前 组 是 
spring.http.encoding; 


OE gals XZJjUTF-8, tee n] f Hi 
spring.http.encoding.charset-2gfi ; 


(3) 设 置 forceEncoding， 默 认为 tue， 若 修改 可 
使 用 Spring.http.encoding.force=false。 


2. fic Bean 


VaR Es, Fee ask PaCS 
CharacterEncodingFilterfJBean, KIRKEE 
Ag: 


@Configuration 
@EnableConfigurationProperties(HttpEncodingProperties.class) 
//1 

@ConditionalOnClass(CharacterEncodingFilter.class) //2 


@ConditionalOnProperty(prefix = "spring.http.encoding", 
value = "enabled", matchIfMissing = true) //3 
public class HttpEncodingAutoConfiguration ( 


@Autowired 
private HttpEncodingProperties httpEncodingProperties; 
77 3 


QBean//4 

@ConditionalOnMissingBean(CharacterEncodingFilter.class) 
//5 

public CharacterEncodingFilter characterEncodingFilter() 


{ 
CharacterEncodingFilter filter = new 
OrderedCharacterEncodingFilter(); 


filter.setEncoding(this.httpEncodingProperties.getCharset(). 
name( )); 


filter.setForceEncoding(this.httpEncodingProperties.isForce( 


)); 


return filter; 


代码 解释 


(D 开 局 属性 注入 ， 通 过 
@EnableConfigurationProperties = 44, 1# H 
@Autowired?# A ; 


0) 当 CharacterEncodingFilter 在 类 路 径 的 条 件 
^ 


(3) 当 设置 spring.http.encoding=enabled 的 情况 
下 ， 如 果 没 有 设置 则 默认 为 tue， 即 条 件 符合 ; 


(4) 像 使 用 Java 配 置 的 方式 配置 


CharacterEncodingFilterix T Bean; 


(G) 当 容器 中 没有 这 个 Bean 的 时 候 狐 建 Bean。 
6.5.4 ”实战 


看 完 前 面 几 广 的 讲述 ， 是 不 是 觉得 Spring 
Boot 的 目 动 配置 其 实 很 答 单 ， 是 不 是 跃跃欲试 地 
想 让 目 己 的 项 目 也 具备 这 样 的 功能 。 其 实 我 们 完 
全 可 以 仿照 上 面 http 编 码 配 置 的 例子 自己 写 一 个 目 
动 配 置 ， 不 过 这 里 再 做 的 彻底 点 ， 我 们 目 己 写 一 
个 starter pom， 这 意味 着 我 们 不 仅 有 目 动 配置 的 功 
能 ， 而 且 具 有 更 通用 的 耦合 度 更 低 的 配置 。 


为 了 方便 理解 ， 在 这 里 举 一 个 简单 的 实战 例 
子 ， 包 舍 当 有 某 个 类 存在 的 时 候 ， 目 动 配置 这 个 关 
的 Bean， 并 可 将 Bean 时 属性 在 
application.properties 中 配置 。 


(1) 新 建 starter 的 Maven 项 目 ， 如 图 6-11 所 


(C. New Maven Project 


New Maven project 
Select project name and location 
C] Create a simple project (skip archetype selection) 
[V] Use default Workspace location 
Location: 
[ ]Add project(s) to working set 
Working set: 


>» Advanced 


Finish 


© New Maven Project a x 
New Maven project 'MI 
Select an Archetype j 
Catalog: All Catalogs "| Configure... 
Fiter: | m i |x 
Group Id Artifact Id Version ^ 
org.apache.cocoon cocoon-22-archetype-webapp RELEASE 
org.apache.maven.archetypes maven-archetype-j2ee-simple RELEASE 
org.apache.maven.archetypes maven-archetype-marmalade-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-portlet RELEASE 


RELEASE 


[V] Show the last version of Archetype only {Include snapshot archetypes 
> Advanced 


@ Se | Eoi | Cancel 


人 New Maven Project 


New Maven project 


Specify Archetype parameters 


Group Id: |com.wisely 
Artifact Id: [sPring-boot-starter-hello 


Version: 0.0.1-SNAPSHOT v 


Package: kom wisely.spring_boot_starter_hello 


Properties available from archetype: 


Name Value 


Remove 


» Advanced 


Finish 


图 6-11 新建 starter 的 Maven 项 目 


在 pom.xml 中 修改 代码 如 下 : 


«project xmlns="http://maven.apache.org/POM/4.0.0" 

xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 

http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<groupId>com.wisely</groupId> 
<artifactId>spring-boot-starter-hello</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>jar</packaging> 


<name>spring-boot-starter -hello</name> 
<url>http://maven.apache.org</url> 


«properties» 
«project.build.sourceEncoding»UTF- 
8«/project.build.sourceEncoding» 
«/properties» 


«dependencies» 
<dependency> 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot -autoconfigure</artifactId> 
<version>1.3.0.M1</version> 
</dependency> 
<dependency> 
«groupId»junit«/groupId-» 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
<!-- 使 用 Spring Boot 正 式 版 时 ， 无 须 下 列 配置 --> 
<repositories> 
<repository> 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.10/snapshot</ur1l> 
<snapshots> 
<enabled>true</enabled> 
</snapshots> 
</repository> 
<repository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.i0/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 
<pluginRepositories> 
<pluginRepository> 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.10/snapshot</url> 
<snapshots> 
<enabled>true</enabled> 


</snapshots> 

</pluginRepository> 

<pluginRepository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.i0/milestone</url> 
<snapshots> 

<enabled>false</enabled> 

</snapshots> 

</pluginRepository> 

</pluginRepositories> 
</project> 


代码 解释 


在 此 处 增加 Spring Boot 目 吴 的 目 动 配置 作为 
依 顿 。 


(2) 属性 配置 ， 代 码 如 下 : 


package com.wisely.spring boot starter hello; 


import 
org.springframework.boot.context.properties.ConfigurationPro 
perties; 


QConfigurationProperties(prefix-"hello") 
public class HelloServiceProperties { 


private static final String MSG - "world"; 
private String msg = MSG; 


public String getMsg() { 
return msg; 


j 


public void setMsg(String msg) 1 
this.msg - msg; 


j 


代码 解释 

这 里 配置 与 6.2.3 市 十 一 样 的 ， 十 类 型 安全 的 
属性 获取 。 在 application.properties 中 通过 
hello.msg= 来 设置 ， 奉 不 设置 ， 默 认为 


hello.msg=world ° 


(3) 判断 依据 类 ， 代 码 如 下 : 


package com.wisely.spring boot starter hello; 
public class HelloService { 
private String msg; 


public String sayHello(){ 
return "Hello" + msg; 


public String getMsg() { 
return msg; 


public void setMsg(String msg) ( 
this.msg - msg; 
} 


代码 解释 


本 例 根 据 此 类 的 存在 与 否 来 创建 这 个 类 的 
Bean， 这 个 类 可 以 是 第 三 方 类 库 的 类 。 


(4 自动 配置 类 ， 代 码 如 下 : 


package com.wisely.spring boot starter hello; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.boot.autoconfigure.condition.Conditional 
OnClass; 

import 
org.springframework.boot.autoconfigure.condition.Conditional 
OnMissingBean; 

import 
org.springframework.boot.autoconfigure.condition.Conditional 
OnProperty; 

import 
org.springframework.boot.context.properties.EnableConfigurat 
ionProperties; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 


@Configuration 
@EnableConfigurationProperties(HelloServiceProperties.class) 
@ConditionalOnClass(HelloService.class) 
@ConditionalOnProperty(prefix = "hello", value = "enabled", 
matchIfMissing = true) 

public class HelloServiceAutoConfiguration { 


@Autowired 
private HelloServiceProperties helloServiceProperties; 


@Bean 
@ConditionalOnMissingBean(HelloService.class) 
public HelloService helloService(){ 
HelloService helloService = new HelloService(); 


helloService.setMsg(helloServiceProperties.getMsg()); 
return helloService; 
j 
j 


代码 解释 


根据 HelloServiceProperties 提 供 的 参数 ， 并 通 
过 @ConditionalOnClass 判 上 新 HelloService 这 个 类 在 
类 路 径 中 是 否 存 在 ， 且 当 容 硕 中 没有 这 个 Bean 的 
情况 下 目 动 配置 这 个 Bean。 


(5) 注册 配置 。 在 6.5.1 中 我 们 知道 ， 若 想 自 
动 配置 生效 ， 需 要 注册 自动 配置 类 。 在 
src/main/resources #1 G{META- 
INF/spring.factories， 结 构 如 图 6-12 所 示 。 


v YS spring-boot-starter-hello 


(588 src/main/Java 
(8 src/test/java 

v (4 src/main/resources 
v [2 META-INMF 


factories 


图 6-12 ”结构 
在 Spring.factories 中 填写 如 下 内 容 注册 : 


org.springframework.boot.autoconfigure.EnableAutoConfigurati 
on=\ 
com.wisely.spring boot starter hello.HelloServiceAutoConfigu 
ration 


BAS TASIACE, WH<, "NF. wt 
处 “Ww 是 为 了 换行 后 仍然 能 读 a 到 属性 。 


另外 ， 大 在 此 例 狐 建 的 项 目 中 无 
src/main/resources 文 件 夹 ， 需 执行 如 图 6-13 所 示 操 
作 。 


Cuv 
Delete 


Remove from Contest Civ! + Alte Shh «Down 
Build Path * 
Alte Shittes » 
AlteShitteT + 


上 
IELE IBALERRE 


© New Source Folder 


Source Folder 


Create a new source folder. 


Project name: | spring-boot-starter-hello 


[ ] Update exclusion filters in other source folders to solve nesting 


[ ]Ignore optional compile problems 


Al6-13 W] Hisrc/maln/resources X44% 


(5) 使 用 starter。 新 建 Spring Boot 项 目 ， 并 


将 我 们 的 starter 作 为 依赖 ， 如 图 6-14 所 示 。 


New Spring Starter Project 


Name 

Type: 

Java Version: 
Boot Version: 
Group 
Artifact 
Version 
Description 


Package 


Dependencies 


[ ]AMQP 


AWS Messaging 


[C] Batch 


Cloud Bus AMQP 
Config Server 


Eureka Server 


[ ]Gemfire 
[ ]HSQLDB 
[ ]JDBC 

[ ]LinkedIn 
[ ] Mustache 
[ ]Redis 


[ ]Security 


[]WS 


在 pom.xml 中 汪 加 Spring-boot-starter-hello 的 依 


Turbine AMQP 


ch6 5 


Maven Project v Packaging: 


18 v Language: 
1.3.0 M1 

com.wisely 

ch6 5 

0.0.1-SNAPSHOT 


Demo project for Spring Boot 


com.wisely.ch6 5 


_| AOP AWS 
[ ]Apache Derby 
|_| Cache 


Cloud Security 


_| Actuator 
Bitronix UTA) 
Cloud Connectors 


_| DevTools [ ]Elasticsearch 


_| Facebook Feign 
]Groovy Templates [ ] H2 


Hystrix 
JMS JPA 

|_| Mail Mobile 
C] MySQL 

[ ]Remote Shell 


OAuth2 


_|Solr |_| Thymeleaf 
口 Vaadin 
Websocket 


Twitter 


Hystrix Dashboard 


[ ]Rest Repositories 


AWS JDBC 


[ ]Atomikos UTA) 


Cloud Bootstrap 
Config Client 


Eureka 


[ ]Freemarker 
[ ]HATEOAS 


Integration 


| |Jersey UAX-RS) 


MongoDB 


[ ]PostgreSQL 


Ribbon 


Turbine 


[ ] Velocity 


Zuul 


图 6-14 新建 Spring Boot 项 目 


A, URSA P: 


«dependency» 
<groupId>com.wisely</groupId> 
<artifactId>spring-boot-starter -hello</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</dependency> 


我 们 可 以 在 Maven 的 依赖 里 查看 spring-boot- 
starter-hello， 如 图 6-15 所 示 。 


Dependency Hierarchy 


v 这 spnng-boot-starter- es 0.0.1-SNAPSHOT a 
v 站 spring-boot-autoconfigure : 1.3.0.M1 [com; 
© spring-boot : 1.3.0.M1 (omitted for conf 


A snakeyaml : 1.15 (omitted for conflict wit 


图 6-15 ##spring-Doot-starter-hello 


在 开发 阶段 ， 我 们 引入 的 依赖 是 spring-boot- 
starter-hello 这 个 项 目 。 在 starter 稳 定之 后 ， 我 们 可 
以 将 spring-boot-starter-hello 通 过 “mvn install” ZZ 
[uan ， 或 者 将 这 个 jar 包 发 布 到 Maven 私 服 


简单 的 运行 类 代码 如 下 : 


package com.wisely.ch6 5; 


Import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplication 


F 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.spring boot starter hello.HelloService; 
QRestController 

QSpringBootApplication 

public class Ch65Application { 


@Autowired 
HelloService helloService; 


QRequestMapping("/") 
public String index(){ 

return helloService.sayHello(); 
j 


public static void main(String[] args) { 
SpringApplication.run(Ch65Application.class, args); 
} 


在 代码 中 可 以 直接 注入 HelloService 的 Bean ， 
但 在 项 目 中 我 们 并 没有 配置 这 个 Bean， 这 是 通过 
目 动 配置 完成 的 。 


访问 http://localhost: 8080， 效 果 如 图 6-16 所 
7e 


g localhost:8080 x 


€ C& | D localhost:8080 


Hello world 


图 6-16 访问 http://local host: 8080 


这 时 在 application.properties 中 配置 msg 的 内 


a 


hello.msg 


- wangyunfei 


此 时 再 次 访问 http://localhost: 8080, XR 
图 6-17 所 示 。 


@ localhost:8080 x 


€ C [5 localhost:8080 


Hello wangyunfei 


图 6-17 查看 效果 


在 application.properties 中 添加 debug 属 性 ， 查 
看 目 动 配置 报告 : 


debug=true 


我 们 新 增 的 目 动 配置 显示 在 控制 台 的 报告 
中 ， 如 图 6-18 所 示 。 


GenericCacheConfiguration 
- Automatic cache type (CacheCondition) 


HelloserviceautoConfiguration | 
= @onditionalOnClass classes found: com.wisely.spring boot starter hello.HelloService (OnClassCondition) 
- matched (OnPropertyCondition) 


|HelloServiceAutoConfiguration#helloService ] 
- gConditionalOnMissingBean (types: com.wisely.spring boot starter hello.HelloService; SearchStrategy: all) found no beans (OnBeanCondition) 


HttpEncodingAutoConfiguration 
- GConditionalOnClass classes found: org.springframework.web.filter.CharacterEncodingFilter (OnClassCondition) 
- matched (OnPropertyCondition) 


HttpEncodingAutoConfigurationicharacterEncodingFilter 
- @ConditionalonMissingBean (types: org.springframework.web.filter.CharactertncodingFilter; SearchStrategy: all) found no beans (OnBeanCondition) 


图 6-18 ”控制 台 报 告 


第 7 章 Spring BootH 朵 Web 开 发 


Web 开 发 是 开发 中 至 天 重要 的 一 部 分 ，Web 
开发 的 核心 内 容 主要 包括 内 柑 Servlet 容 器 az Spring 
MVC ° 


7.1 Spring BootH' JWebJ7T Z 3c $5 


Spring Boot? f: T spring-boot-starter-web7J 
Web 开 发 予以 支持 ，spring-boot-starter-web 为 我 们 
提供 了 舱 入 的 Tomcat 以 及 Spring MVC 的 依赖 。 而 
Web 相 天 的 目 动 配置 存储 在 spring-boot- 
autoconfigure.jar 的 
org.springframework.boot.autoconfigure.web 下 ， 如 


图 7-1 所 示 。 


HB web 
> tt BasicErrorController.class 
> $h DefaultErrorAttributes.class 
> $h DispatcherServletAutoConfiguration.class 
> $h EmbeddedServletContainerAutoConfiguration.class 
> d ErrorAttributes.class 
> 1» ErrorController.class 
> tm ErrorMvcAutoConfiguration.class 
ii) GsonHttpMessageConvertersConfiguration.class 
li GzipFilterAutoConfiguration.class 
li» GzipFilterProperties.class 
> 48 HttpEncodingAutoConfiguration.class 
> $S HttpEncodingProperties.class 
U HttpMessageConverters.class 
bs HttpMessageConvertersAutoConfiguration.class 
$ JacksonHttpMessageConvertersConfiguration.class 
i» JspTemplateAvailabilityProvider.class 
L5 MultipartAutoConfiguration.class 
£3 MultipartProperties.class 
b ResourceProperties.class 
lu) ServerProperties.class 
tn) ServerPropertiesAutoConfiguration.class 
> i» WebMvcAutoConfiguration.class 
> t» WebMvcProperties.class 


图 7-1 Web 相关 的 上 自动 配置 
从 这 些 文件 名 可 以 看 出 : 


e ServerPropertiesAutoConfiguration 和 
ServerProperties E 5AL A.N Ek Servlet ai ; 

。HttpEncodingAutoConfiguration 和 
HttpEncodingProperties 用 来 目 动 配 置 http 的 编 
位; 

e MnultipartAutoConfiguration 和 


MultipartProperties 用 来 目 动 配 置 上 传 文件 的 属 
TE; 


e JacksonHttpMessageConvertersConfiguration Hi 
来 目 动 配置 mappingJackson2Http 
MessageConverter 和 
mappingJackson2XmlHttpMessage Converter; 

e WebMvcAutoConfiguration dli WebMvcProperties 
配置 Spring MVC ° 


7.2 ”Thymeleaf 模 板 引 擎 


本 书 前 面 的 内 容 很 少 用 到 页 面 模板 引擎 相 天 
的 内 容 ， 侦 尔 使 用 了 JSP 页 面 ， 但 是 尽 可 能 少 地 涉 
及 JSP 相 关 知 识 ， 这 十 因为 JSP 在 内 藤 的 Servlet 的 
容器 上 运行 有 一 些 问题 (A fkTomcat ` Jetty AX 
持 以 jar 形 式 运行 JSP，Undertow 不 支持 JSP) ° 


Spring Boot 提 供 了 大 量 模板 引擎， 包含 括 
FreeMarker ` Groovy、Thymeleaf、Velocity 和 
Mustache, Spring Boot 中 推荐 使 用 Thymeleaf 作 为 
模板 3 引擎， 因为 Thymeleaf 提 供 了 完美 的 Spring 
MVC 的 支持 。 


7.2.1 Thymeleaf 基 础 知识 


Thymeleaf 是 一 个 Java 类 库 ， 它 是 一 个 
xml/xhtmlhtml5 的 模板 引擎， 可 以 作为 MVC 的 
Web 应 用 的 View 层 。 


Thymeleafi 不 提供 了 额外 的 模块 邱 Spring MVC 
集成 ， 所 以 我 们 可 以 使 用 Thymeleaf 完 全 百代 


JSP» 


下 面 我 们 演示 日 常 工 作 中 常用 的 Thymeleaf 用 
法 ， 我 们 将 把 本 廊 的 内 容 在 7.2.4 太 运行 演示 。 


1.5| A Thymeleaf 


下 面 的 代码 是 一 个 基本 的 Thymeleaf 模 板 页 
面 ， 在 这 里 我 们 引入 了 Bootstrap (作为 样式 控 
Z 和 jQuery (DOM 操 作 ) ， 当 然 它 们 不 是 必需 


«html xmins:th="http://www.thymeleaf.org"><!-- 1 --> 
<head> 
«meta content="text/html;charset=UTF-8"/> 
«link a c ea a a 
rel="stylesheet"/> <!-- 2 --> 
<link th:src= "@{bootstrap/css/bootstrap- theme.min.css}" 
rel="stylesheet"/><!-- 2 --> 
</head> 
<body> 


«script th:src="@{jquery-1.10.2.min.js}" 
type=' ves ae '></script><!-- 2 --> 


<script th:src= iarbootstrap/1s/bosestrap: min.js}"> 
</script><!-- 2 --> 

</body> 
</html> 


代码 解释 


通过 xmlns: th=http://www. thymeleaf. org tj 


名 空间 ， 将 镜头 页面 转换 为 动态 的 视图 。 需 要 进 


行动 态 处 理 的 元 素 将 使 用 “th: ” HAR: 


器 通过 “@1{}”3 引 用 Web 静 态 资 源 ， 这 在 JSP 下 
是 极 易 出 错 的 。 


2. 访 问 model 中 的 数据 


m 通过 “${}” 访 问 model 中 的 属性 ， 这 和 JSP 极 为 
HALL o 


«div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">ijj/Almodel</h3> 
</div> 
<div class="panel-body"> 
<span th:text="${singlePerson.name}"></span> 
</div> 
</div> 


代码 解释 


使 用 <span th: text="${singlePerson.name}"> 
span>} n]model "P HsinglePersonB'Jname/& Tt ° 
注意 : 需要 处 理 的 动态 内 容 需 要 加 上 “th: "BUZ& ° 


3.model 中 的 数据 送 代 


Thymeleaf 的 适 代 和 JSP 的 写法 也 很 相似 ， 代 
RIAN P: 


«div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">|#</h3> 
</div> 
<div class="panel-body"> 
<ul class="list-group"> 
«li class="list-group-item" 
th:each="person:${people}"> 
<span th:text="${person.name}"></span> 
<span th:text="${person.age}"></span> 
</li> 
</ul> 
</div> 
</div> 


代码 解释 


使 用 th: each 来 做 循环 迭代 (th: 
each="person: ${people}") ，person 作 为 迭代 元 素 
E 然后 像 上 面 一 样 访 问 和 迭代 元 素 中 的 属 


4. 效 据 判断 
代码 如 下 : 


«div th:if="${not #lists.isEmpty(people) }"> 
«div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">l|#</h3> 
</div> 
<div class="panel-body"> 
«ul class="list-group"> 
<li class="list-group-item" 
th:each="person:${people}"> 
<span th:text="${person.name}"></span> 
<span th:text="${person.age}"></span> 


</li> 
</ul> 
</div> 
</div> 
</div> 


代码 解释 


通过 ${fnot 刘 ists.isEmpty (people) } 表 达 式 判 
I/rpeopleze CKE ° Thymeleaf3X F> ` <` >= >` 
<=== > | = 作为 比较 条 件 ， 同 时 也 文 持 将 
SpringEL 表 达 式 语言 用 于 条 件 中 。 


5.%Æ JavaScript t 7j |h]model 


在 项 目 中 ， 我 们 经 昔 需 要 在 JavaScript 访 问 
model 中 的 值 ， 在 Thymeleaf 里 实现 代码 如 下 : 


<script th:inline="javascript"> 
var single = [[${singlePerson}]]; 
console. log(single.name+"/"+single.age) 
</script> 


代码 解释 


。 通 过 th: inline=“javascript” ýN IN 8l] scripts , 
这 样 JavaScript 代 码 即 可 访问 model 中 的 属性 ; 
。 通 过 “[[${}]]” 格 式 获 得 实际 的 值 。 


还 有 一 种 是 需要 在 html 的 代码 里 访问 model 中 
的 属性 ， 例 如 ， 我 们 需要 在 列表 后 单 击 每 一 行 后 
面 的 按钮 获得 model 中 的 值 ， 可 做 如 下 处 理 : 


«li class="list-group-item" th:each="person:${people}"> 
<span th:text="${person.name}"></span> 
<span th:text="${person.age}"></span> 
«button class="btn" th:onclick="'getName(\'' + 
${person.name} + '\');'"> 获 得 名 字 </button> 
</li> 


代码 解释 
注意 格式 中 : onclick="getName 
(\"+${person.name}+'\') ; ™ o 


6. 其 他 知识 


更 多 更 完整 的 Thymeleaf 的 知识 ， 请 查看 
http:/www.thymeleaf.org 的 官网 。 


7.2.2 Spring MVC 集 成 


TE Spring MVC'P, ERI 108 RR E— 1 RR 
引擎 的 话 ， 需 要 定义 ViewResolver， 而 
ViewResolver 需 要 定义 一 个 View， 如 4.2.2 广 中 我 
们 为 JSP 定 义 的 ViewResolver 的 代码 : 


QBean 
public InternalResourceViewResolver viewResolver(){ 

InternalResourceViewResolver viewResolver - new 

InternalResourceViewResolver(); 
viewResolver.setPrefix("/WEB-INF/classes/views/"); 
viewResolver.setSuffix(".jsp"); 
viewResolver.setViewClass(JstlView.class); 
return viewResolver; 


j 


通过 上 面 的 代码 可 以 看 出 ， 使 用 JsltView 定 义 
了 一 个 InternalResourceViewResolver， 因 而 使 用 
Thymeleaf 作 为 我 们 的 模板 引 敬 也 应 该 做 类 似 的 定 
义 。 庆 对 的 是 ，Thymeleaf 为 我 们 定义 好 了 
org.thymeleaf.spring4.view.ThymeleafView 和 
org.thymeleaf.spring4.view. ThymeleafViewResolver 

(默认 使 用 ThymeleafView 作 为 View) 。 

Thymeleaf 给 我 们 提供 了 一 个 SpringTemplateEngine 
类 ， 用 来 驱动 在 Spring MVC 下 使 用 Thymeleaf 模 板 
引擎 ， 另 外 还 捉 供 了 一 个 TemplateResolver 用 来 设 
置 通用 的 模板 引 警 (包含 前 级 、 后 级 等 ， 这 使 
我 们 在 Spring MVC 中 集成 Thymeleaf 引 擎 变 得 十 分 
人 简单， 代码 如 下 : 


QBean 

public TemplateResolver templateResolver(){ 

TemplateResolver templateResolver = new 
ServletContextTemplateResolver(); 

templateResolver.setPrefix("/WEB-INF/templates"); 

templateResolver.setSuffix(".htm1"); 

templateResolver.setTemplateMode("HTML5"); 

return templateResolver; 


j 


QBean 

public SpringTemplateEngine templateEngine(){ 

SpringTemplateEngine templateEngine - new 
SpringTemplateEngine(); 

templateEngine.setTemplateResolver(templateResolver()); 

return templateEngine; 


jJ 


QBean 

public ThymeleafViewResolver thymeleafViewResolver (){ 

ThymeleafViewResolver thymeleafViewResolver - new 
ThymeleafViewResolver(); 


thymeleafViewResolver.setTemplateEngine(templateEngine()); 

// 

thymeleafViewResolver.setViewClass(ThymeleafView.class); 
return thymeleafViewResolver; 


j 


7.3.3 Spring BootHJThymeleaf 文 持 


在 上 一 三 我 们 讲述 了 Thymeleaf 与 Spring MVC 
集成 的 配置 ， 讲 述 的 目的 是 为 了 方便 大 家 理解 
Spring MVC 和 Thymeleaf 集 成 的 原理 。 但 在 Spring 
Boot 中 这 一 切 都 是 不 需要 的 ，Spring Boot 通 过 
org.Springframework.boot.autoconfigure.thymeleaf 包 


对 Thymeleaf 进 行 了 目 动 配置 ， 如 图 7-2 所 示 。 


H3 thymeleaf 


bū ThymeleafAutoConfiguration.class 


ls ThymeleafProperties.class 


kib ThymeleafTemplateAvailabilityProvider.class 


图 7-2 thymeleaf 包 


通过 ThymeleafAutoConfiguration 类 对 集成 所 
需要 的 Bean 进 行 目 动 配置 ， 包 括 
templateResolver ` templateEngine 和 
thymeleafViewResolverHYJ 配 置 。 


通过 ThymeleafProperties 来 配置 Thymeleaf ， 在 
application.properties 中 ， 以 Spring.thymeleaf 开 头 来 
配置 ， 通 过 查看 ThymeleafProperties 的 主要 源码 ， 
我 们 可 以 看 出 如 何 设置 属性 以 及 默认 配置 : 


QConfigurationProperties("spring.thymeleaf") 
public class ThymeleafProperties { 


public static final String DEFAULT PREFIX - 
"classpath:/templates/"; 


public static final String DEFAULT SUFFIX - ".html"; 
£o 
BIZ, Spring Boot 默 认 模 板 ， 防 止 在 classpath:/templates/ 
目录 下 
+f 


private String prefix = DEFAULT_PREFIX; 


/** 
* eax, 默认 为 html 


*/ 
private String suffix = DEFAULT_SUFFIX; 


/** 
* 模板 模式 设置 ， 默 认为 HTML 5 
private String mode = "HTML5"; 


/[** 

* 模板 的 编码 设置 ， 默 认为 UTF-8 

*/ 

private String encoding = "UTF-8"; 


/** 


* 模板 的 媒体 类 型 设置 ， 默认 为 text/html. 
*/ 
private String contentType = "text/html"; 


* 是 否 开启 模板 缓存 ， 默 认 是 开启 ， 开 发 时 请 关闭 
a 

private boolean cache = true; 

{feis 


7.2.4 XER 


1.38155 Spring Boot 项 目 


选择 Thymeleaf 依 顿 ，spring-boot-starter- 
thymeleaf 会 目 动 包含 spring-bootrstarter-web 4H 
7-3 所 不。 


Maven Project ~ 


1.30 M1 


com.wisely 


ch? 2 
0.0.1 SNAPSHOT 
Demo project for Spring Boot 


com.wisely 


| ]|AMQP | JAOP AWS 
AWS Messaging ([() Actuator [ ] Apache Derby 
|_| Batch Bitronix (TA) | ] Cache 
Cloud Bus AMQP [Cloud Connectors Cloud Security 
Config Server DevTools | ]£lasticsearch 
Eureka Server M Facebook feign 


| ]Gemfire Groovy Templates | |H2 


| |JDBC | JPA 

口 Unkedin Mobile 

| Mustache | OAuth2 

C Redis 

| Security 
Turbine AMQP 

[1ws 


CJ HSQLOR Hyetres Hystria Dashboard 


AWS JDBC 

DD Atomikos (ITA) 
Cloud Bootstrap 
Config Client 
Eureka 

[JFreemarker 

| JHATEOAS 

[Integration 

| Mersey UAX-RS) 

口 MongoDB 

| PostgreSQL 
Ribbon 
Turbine 

(Velocity 


Zuul 
čuu 


K7-3 新建 Spring Boot™ H 


2. 示 例 JavaBean 


此 类 用 来 在 模板 页 面 展示 数据 用 ， 


属性 和 age 属 性 : 


包 name 


package com.wisely; 


public class Person ( 
private String name; 
private Integer age; 


public Person() { 
super(); 
public Person(String name, Integer age) { 
super(); 
this.name = name; 
this.age = age; 


public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


public Integer getAge() { 
return age; 
} 


public void setAge(Integer age) { 


this.age = age; 


} 


3. 脚 本 样式 前 仿 文 件 


根据 默认 原则 ， 脚 本 样式 、 图 片 等 静态 文件 
应 放置 在 src/main/resources/static 下， 这 里 引入 了 
Bootstrap 和 和 jQuery， 结构 如 图 7-4 所 示 。 


(48 src/main/resources 


wv [ static 
(= bootstrap 
jauery-1.10.2.min.js 


图 7-4 文件 位 置 
4. TELZIS UA IR] 
根据 默认 原则 ， 页 面 应 放置 在 


src/main/resources/templates ^ ° 在 
src/main/resources/templates | #1 index.html, 4 
图 7-5 所 示 。 


4 src/main/resources 
=> static 


w [= templates 
index.html 


图 7-5 ”新建 index.html 
代码 如 下 : 


«html xmins:th="http://www.thymeleaf.org"> 
<head> 


«meta content-z"text/html;charset-UTF-8"/» 
«meta http-equiv="X-UA-Compatible" content="IE=edge"/> 
«meta name="viewport" content="width=device-width, 
initial-scale=1"/> 
«link th:href="@{bootstrap/css/bootstrap.min.css}" 
rel="stylesheet"/> 
«link th:href="@{bootstrap/css/bootstrap-theme.min.css}" 
rel="stylesheet"/> 
</head> 
<body> 


<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class-"panel-title"»7ji|model«/h3» 
</div> 
<div class="panel-body"> 
«span th:text="${singlePerson.name}"></span> 
</div> 
</div> 


«div th:if="${not #lists.isEmpty(people) }"> 
<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">!|#</h3> 
</div> 
<div class="panel-body"> 
«ul class="list-group"> 
«li class-"list-group-item" 
th:each="person:${people}"> 
<span th:text="${person.name}"></span> 
<span th:text="${person.age}"></span> 
<button class="btn" 
th:onclick="'getName(\'' + ${person.name} + '\');'">3k EB F 
</button> 


</li> 
</ul> 
</div> 
</div> 
</div> 


«script th:src="@{jquery-1.10.2.min.js}" 
type="text/javascript"></script><!-- 2 --> 

<script th:src="@{bootstrap/js/bootstrap.min.js}"> 
</script><!-- 2 --> 


«script th:inline="javascript"> 
var single = [[${singlePerson}]]; 
console.log(single.name+"/"+single.age) 


function getName(name){ 
console.log(name); 


} 


</script> 


</body> 
</html> 


5. 数 据 准备 
代码 如 下 : 


package com.wisely; 


import java.util.ArrayList; 
import java.util.List; 


import org.springframework.boot.SpringApplication; 
import 
org.springframework.boot.autoconfigure.SpringBootApplication 


import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
@Controller 

@SpringBootApplication 

public class Ch72Application { 


QRequestMapping("/") 
public String index(Model model) { 
Person single - new Person("aa",11); 


List«Person» people = new ArrayList<Person>(); 


Person pi = new Person("xx",11); 
Person p2 = new Person("yy", 22); 
Person p3 = new Person("zz",33); 


3 
people.add(p1); 


people.add(p2); 
people.add(p3); 


model.addAttribute("singlePerson", single); 
model.addAttribute("people", people); 


return "index"; 


j 


public static void main(String[] args) { 
SpringApplication.run(Ch72Application.class, args); 


j 


6. 运 行 

访问 http:Wlocalhost: 8080， 歼 果 如 图 7-6 所 
ZR o 

单 击 “获得 名 字 ? 人 选项 ， 歼 来 如 图 7-7 所 示 。 


' @ localhost:8080 x 
€ > Œ D localhost:8080 vy e@ = 


i5 |n]model 


G Y <topframe> v © Preserve log 
(inden) 52 


> 


Al7-6 ”访问 http://localhost: 8080 


© Y -topfame» 9 [O Preserve log 


aa/11 (index) :52 
(index):55 
(index):55 
(index):55 


Al7-7 单 击 获得 名 字 


7.3 ”Web 相关 配置 


7.3.1 Spring Boot 提 供 的 目 动 配置 


通过 查看 WebMvcAutoConfiguration 太 
WebMvcProperties 的 源码 ， 可 以 发 现 Spring Boot 为 
我 们 提供 了 如 下 的 目 动 配置 。 


1. 目 动 配置 的 ViewResolver 


(1) ContentNegotiatingViewResolver 


这 是 Spring MVC 提 供 的 一 个 特殊 的 
ViewResolver，ContentNegotiatingViewResolver 不 
是 目 己 处 理 View， 而 是 代理 给 不 同 的 
ViewResolver 来 处 理 不 同时 View， 所 以 它 有 最 高 
的 优先 级 。 


(2) BeanNameViewResolver 


在 控制 器 (@Controller) 中 的 一 个 方法 的 返 
回 值 的 字符 串 (视图 名 ) 会 根据 
BeanNameViewResolver 去 查找 Bean 的 名 称 为 返回 


字符 串 的 View 来 演 染 视图 。 是 不 是 不 好 理解 ， 下 
面 举 个 小 例子 。 


定义 BeanNameViewResolver 上 的 Bean: 


QBean 
public BeanNameViewResolver beanNameViewResolver() ( 
BeanNameViewResolver resolver - new 
BeanNameViewResolver(); 
return resolver; 


j 


定义 一 个 View 的 Bean， 名 称 为 jsonView: 


QBean 
public MappingJackson2JsonView jsonView()( 
MappingJackson2JsonView jsonView - new 
MappingJackson2JsonView(); 
return jsonView; 
} 


EaP, WME + FF json View, 
会 找 Bean 的 名 称 为 jsonView 的 视图 来 泻 染 : 


5} 


QRequestMapping(value = "/json",produces= 
{MediaType .APPLICATION_JSON_VALUE}) 
public String json(Model model) { 
Person single = new Person("aa", 11); 
model.addAttribute("single", single); 
return "jsonView"; 


(3) InternalResourceViewResolver 


这 个 是 一 个 极为 单 用 的 ViewResolver， 主 要 通 
TZAR R, UK har PA ERRE 
图 名 的 字符 串 ， 以 得 到 实际 页 面 ，Spring Booth 
Us ug P: 


QBean 


QConditionalOnMissingBean(InternalResourceViewResolver.class 
) 

public InternalResourceViewResolver 
defaultViewResolver() { 


InternalResourceViewResolver resolver - new 
InternalResourceViewResolver(); 

resolver.setPrefix(this.prefix); 

resolver.setSuffix(this.suffix); 

return resolver; 


j 
2. B SIC ELE AS E UR 


在 目 动 配置 类 的 addResourceHandlers 方 法 中 
XE X. f A PERS PE URB BBC ° 


(1) 类 路 径 文 件 


把 类 路 径 下 的 /static、/public、/resources 
和 /META-INF/resources 文 件 夹 下 的 静态 文件 直接 
映 山 为 /**， 可 以 通过 http://localhost: 8080/** 来 访 
[A] o 


(2) webjar 


何谓 webjar，webjar 了 驶 是 将 我 们 第 用 的 脚本 框 
架 封 痛 在 jar 包 中 的 jar 包 ， 更 多 关于 webjar 的 内 容 
请 访问 http://www.webjars.org 网 站 。 


把 webjar 的 /META-INF/resources/webjars/ 下 的 ] 
静态 文件 映射 为 /webjarv**， 可 以 通过 
http://localhost: 8080/webjar/**2K 3j ja] ° 


3. 目 动 配置 的 Formatter 和 Converter 


天 于 目 动 配置 Formatter 和 Converter， 我 们 可 
以 看 一 下 WebMvcAutoConfiguration 类 中 的 定义 : 


QOverride 
public void addFormatters(FormatterRegistry 
registry) { 
for (Converter<?, ?> converter : 
getBeansOfType(Converter.class) ){ 
registry.addConverter(converter); 


j 


for (GenericConverter converter : 
getBeansOfType(GenericConverter.class)) { 
registry.addConverter(converter); 


for (Formatter<?> formatter : 
getBeansOfType(Formatter.class)) ( 
registry.addFormatter(formatter); 


j 


private «T» Collection<T> getBeansOfType(Class<T> 


type) { 
return 


this.beanFactory.getBeansOfType(type).values(); 
} 


从 代码 中 可 以 看 出 ， 只 要 我 们 定义 了 
Converter ` GenericConverter#/ Formatter#2 O AY) 
现 关 的 Bean， 这 些 Bean 束 会 目 动 注册 到 Spring 
MVC 中 。 


4. 目 动 配置 的 HttpMessageConverters 


在 WebMvcAutoConfiguration 中 ， 我 们 注册 了 
messageConverters， 代 人 码 如 下 ; 


@Autowired 
private HttpMessageConverters messageConverters; 


QOverride 

public void 
configureMessageConverters(List<HttpMessageConverter<?>> 
converters) { 


converters.addAll(this.messageConverters.getConverters()); 


j 


TEX HB eV A f HttpMessageConvertersH’) 
Bean， 而 这 个 Bean 是 在 
HttpMessageConvertersAutoConfiguration 类 中 定义 
的 ， 我 们 目 动 注册 的 HttpMessage Converter 除 了 
Spring MVC 默 认 的 
ByteArrayHttpMessageConverter ^ 
StringHttpMessage Converter ` Resource 


HttpMessageConverter ^ 
SourceHttpMessageConverter » AllEncompassing 
FormHttpMessageConverter 外 ， 在 我 们 的 
HttpMessageConverters AutoConfiguration 上 的 目 动 配 
置 文件 里 还 引入 了 JacksonHttpMessageConverters 
Configuration 和 GsonHttpMessage 
ConverterConfiguration， 使 我 们 获得 了 额外 的 
HttpMessageConverter: 


。 各 jackson 的 jar 包 在 类 路 径 上 ， 则 Spring Boot 通 
过 JacksonHttpMessage Converters Configuration 
增加 MappingJackson2HttpMessage Converter 和 
Mapping Jackson2 XmlHttpMessageConverter; 

。 奉 gson 有 的 jar 包 在 类 路 人 笃 上 ， 则 Spring Boot 通 过 
GsonHttpMessageConverter Configuration 增 加 
GsonHttpMessageConverter ? 


在 Spring Boot 中 ， 如 采 要 新 增 日 定义 的 
HttpMessageConverter， 则 只 和 需 定 义 一 个 你 目 己 的 
HttpMessageConverters 的 Bean， 然 后 在 此 Bean 中 
注册 目 定 义 HttpMessageConverter 即 可 (f|: 


QBean 
public HttpMessageConverters customConverters() { 
HttpMessageConverter«?» customConverteri- new 
CustomConverter1(); 
HttpMessageConverter«?» customConverter2- new 
CustomConverter2(); 
return new HttpMessageConverters(customConverter1, 


customConverter2); 


5S BLA CSF 
把 前 态 index.html 文 件 放 置 在 如 下 目录 。 


。 classpath: /META-INF/resources/index.html 
e classpath: /resources/index.html 

e classpath: /static/index.html 
。 classpath: /public/index.html 


当 我 们 访 间 应 用 根 目 录 http://localhost: 8080/ 
IY, ZEB o 


7.3.2 Spring BootHJWebHBU ©. 


"ll o Spring Boot 提 供 的 Spring MVC 不 符合 要 
求 ， 则 可 以 通过 一 个 配置 类 (注解 有 
@Configuration 的 类 ) 加 上 @EnableWebMvc 注 解 
来 实现 完全 目 己 控制 的 MVC 配 置 。 


当然 ， 通 第 情况 下 ，Spring Boot 的 目 动 配置 
是 符合 我 们 大 多 数 需 求 的 。 在 你 既 需 要 保留 Spring 
Boot 提 供 的 便利 ， 又 需要 增加 目 己 的 额外 的 配置 
的 时 候 ， 可 以 定义 一 个 配置 类 并 继承 


WebMvcConfigurerAdapter， 无 须 使 用 
@EnablewebMvc 注 解 ， 然 后 Mum 4 章 讲 解 的 
Spring MVC 的 配置 方法 来 添加 Spring Boot 为 我 们 
所 做 的 其 他 配置 ， 例 如 : 


QConfiguration 
public class WebMvcConfig extends WebMvcConfigurerAdapter { 
QOverride 
public void addViewControllers(ViewControllerRegistry 
registry) { 


registry.addViewController("/xx").setViewName("/xx"); 


j 


值得 指出 的 是 ， 在 这 里 重 写 的 
addViewControllers/] 3, JF RABE 
WebMvcAutoConfiguration # #‘JaddViewControllers 

(在 此 方法 中 ，Spring Boot RJ 
index.html) ， 这 也 束 意 味 着 我 们 目 己 的 配置 和 
Spring Boot 的 目 动 配置 同时 有 效 ， 这 也 第 我 们 推 
荐 添加 自己 的 MVC 配 置 的 方式 。 


7.3.3 YH} Servlet ` Filter ` Listener 


4 (EHARA RA Servlet#4s (Tomcat ` Jetty 
SE) 时 ， 我 们 通过 将 Servlet、Filter 和 Listener 声 明 
为 Spring Bean 而 达到 注册 的 效 末 ; 或 者 注册 


ServletRegistrationBean、FilterRegistrationBean 和 
ServletListenerRegistrationBeanf'JBean ° 


(1) 直接 注册 Bean 示 例 ， 代 人 码 如 下 : 


QBean 
public XxServlet xxServlet (){ 

return new XxServlet(); 

} 

QBean 

public YyFilter yyFilter ()( 
return new YyFilter(); 

} 


QBean 
public ZzListener zzListener ()( 
return new ZzListener(); 


} 


(2) 通过 RegistrationBean 示 例 : 


QBean 
public ServletRegistrationBean servletRegistrationBean() 


x 
return new ServletRegistrationBean(new 
XxServlet()," /xx/*"); 
} 
QBean 
public FilterRegistrationBean filterRegistrationBean(){ 
FilterRegistrationBean registrationBean - new 
FilterRegistrationBean(); 
registrationBean.setFilter( new YyFilter()); 
registrationBean.setOrder(2); 
return registrationBean; 


j 


QBean 
public ServletListenerRegistrationBean<ZzListener> 
zzListenerServletRegistrationBean(){ 


return new 
ServletListenerRegistrationBean<ZzListener>(new 
ZzListener()); 


7.4 ” Tomcat 配置 


本 市 里 然 叫 Tomcat 配 置 ， 但 其 实 指 的 是 servlet 
容 希 的 配置 ， 因 为 Spring Booth AW ERE Tomcat 
为 servlet 容 右 ， 所 以 本 万 只 讲 对 Tomcat 配 置 ， 其 实 
本 万 的 配置 对 Tomcat、Jetty 和 Undertow 都 是 通用 
的 。 


7.4.1 Bü Tomcat 


天 于 Tomcat 的 所 有 属性 都 在 
org.springframework.boot.autoconfigure.web.ServerP 
roperties 配 置 类 中 做 了 定义 ， 我 们 只 需 在 
application.properties 配 置 属性 做 配置 即 可 。 通 用 的 
Servlet 容 希 配 置 都 以 "server" 作 为 前 缀 ， 而 Tomcat 
特有 配置 都 以 “server.tomcat* 作 为 前 级 。 下 面 举 一 
ees ALIA ° 


Wr E ServletZ 48: 


server .port= 4f ESL, RA 48080 
server.session-timeout- # 用 户 会 话 session 过 期 时 间 ， 以 秒 为 单位 
server ,context-path= # 配 置 访问 路 径 ， 默 认为 / 


配置 Tomcat: 


server.tomcat.uri-encoding = # 配 置 Tomcat 编 码 ， 默 认为 UTF-8 
server.tomcat.compression- # Tomcat 是 否 开启 压缩 ， 默 认为 关闭 off 


E HFA Servlet i EN Tomcat E, 
请 查看 附 永 A 中 以 “server"” 和 “servertomcat” 为 前 级 
的 配置 。 


7.4.2 ”代码 配置 Tomcat 


如 有 果 你 需要 通过 代码 的 方式 配置 servlet 容 屁 ， 
则 可 以 注册 一 个 实现 
EmbeddedServletContainerCustomizer 接 口 的 Bean: 
若 想 直接 配置 Tomcat、Jetty、Undertow， 则 可 以 
HEEN 
TomcatEmbeddedServletContainerFactory ` 
JettyEmbeddedServletContainer Factory ` 
UndertowEmbeddedServletContainerFactory ° 


1. 通 用 配置 
(1) 新 建 类 的 配置 : 


package com.wisely.ch7_4; 


import java.util.concurrent.TimeUnit; 


Import 
org.springframework.boot.context.embedded.ConfigurableEmbedd 
edServletContainer; 

import 
org.springframework.boot.context.embedded.EmbeddedServletCon 
tainerCustomizer; 

import org.springframework.boot.context.embedded.ErrorPage; 
import org.springframework.http.HttpStatus; 

import org.springframework.stereotype.Component; 


Component 
public class CustomServletContainer implements 
EmbeddedServletContainerCustomizer{ 


@Override 
public void 
customize(ConfigurableEmbeddedServletContainer container) { 
container.setPort(8888); //1 
container .addErrorPages (new 
ErrorPage(HttpStatus.NOT FOUND, "/404.htm1"));//2 
container.setSessionTimeout(10,TimeUnit.MINUTES); 
//3 


(2) 当前 配置 文件 内 配置 。 若 要 在 当前 已 有 
的 配置 文件 内 添加 类 的 Bean 的 话 ， 则 在 Spring 配 置 
中 ， 注 意 当前 类 要 声明 为 static: 


QSpringBootApplication 
public class Ch74Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch74Application.class, args); 
j 


QComponent 
public static class CustomServletContainer implements 
EmbeddedServletContainerCustomizer{ 


QOverride 
public void 
customize(ConfigurableEmbeddedServletContainer container) { 
container.setPort(8888); //1 
container.addErrorPages(new 
ErrorPage(HttpStatus.NOT FOUND, "/404.htm1"));//2 


container.setSessionTimeout(10,TimeUnit.MINUTES); //3 
} 


2. 特 定 配置 
下 面 以 Tomcat 为 例 Jetty fi H 


JettyEmbeddedServletContainerFactory, Undertow 


便 用 


UndertowEmbeddedServletContainerFactory ) 


@Bean 
public EmbeddedServletContainerFactory 
servletContainer() { 
TomcatEmbeddedServletContainerFactory factory = new 
TomcatEmbeddedServletContainerFactory(); 
factory.setPort(8888); //1 
factory.addErrorPages(new ErrorPage(HttpStatus.NOT FOUND, 
"/404.htm1"));//2 
factory.setSessionTimeout(10, TimeUnit.MINUTES); //3 
return factory; 


代码 解释 
上 面 两 个 例子 的 代码 部 实现 了 这 些 功 能 


配置 端口 号 ; 


配置 错误 页 面 ， 根 据 HttpStatus 中 的 错误 状 
仿 信 息 ， 直 接 转 癌 错 误 页 面 ， 其 中 404.html 放 置 在 


src/main/resources/static 下 即 可 ; 


(3) 配 置 Servlet 容 器 用 户 会 话 (session) 过 期 时 
|] » 


7.4.3 7842Tomcat 


Spring Boot V fs: H Tomcat fE 73 A EKServlet zt 
， 碍 看 Spring-boot-starter-web 依 顿 ， 如 图 7-8 所 


ES: 


(3 spring-boot-starter-web : 1.3.0.M1 [compile] 
(3 spring-boot-starter : 1.3.0.M1 (omitted for conflict with 
v A spring-boot-starter-tomcat : 1.3.0.M1 [compile] 
0 tomcat-embed-core : 8.0.23 [compile] 
| tomcat-embed-el : 8.0.23 [compile] 
(3 tomcat-embed-logging-juli : 8.0.23 [compile] 
v 站 tomcat-embed-websocket : 8.0.23 [compile] 
A tomcat-embed-core : 8.0.23 (omitted for conflict | 


Al7-8 ”查看 Spring-boot-starter-web 依 赖 


UREE FA Jetty 24 Undertow Nsewvlet as , 
只 需 修 改 spring-boot-starter-web 的 依赖 即 可 。 


1. EH Jetty 


在 pom.xml 中 ， 将 Spring-boot-starter-web 的 依 
Wt EHspring-boot-starter-tomcat 14: 7Jspring-boot- 
starter-Jetty : 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 
<exclusion> 


«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter- 
tomcat</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupid> 
<artifactId>spring-boot-starter- 
jetty</artifactId> 
</dependency> 


此 时 局 动 Spring Boot, fib S 8 £i CR AU ES 7- 
9 所 示 。 


Started ServerConnector@1@6cb@8{HTTP/1.1}{@.0.0.0: 8080} 


pete rid on port(s) 8080 (http/1.1) 


arted Ch72Application in 4.877 seconds (JVM running for 4.4608) 


图 7-9 fite e LR 
2 Ft Undertow 


在 pom.xml 中 ， 将 spring-boot-starter-web 的 依 
Wt EHspring-boot-starter-tomcat £517; spring-boot- 
starter-undertow: 


«dependency» 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 
<exclusion> 


«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
tomcat</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
under tow</artifactId> 
</dependency> 


此 时 启动 Spring Boot， 控 制 合 输出 效果 如 图 7- 
10 所 示 。 


Undertow started on port(s) 8088 (http) 
Started Ch72Application in 2.26 seconds (JVM running for 2.578) 


Al7-10 控制 合 输出 效果 


7.4.4 SSL 配置 


_ SSL 的 配置 也 十 我 们 在 实际 应 用 "HESSE RS ll A) 


D p 


SSL (Secure Sockets Layer, PERE) 是 
为 网 络 通信 提供 安全 及 数据 完整 性 的 一 种 安全 协 
议 ，SSL 在 网 络 传输 层 对 网 络 连 接 进 行 加 蜜 。SSL 
协议 位 于 TCP/IP 协 议 与 各 种 应 用 层 协 议 之 旧 ， 为 
数据 通信 提供 安全 支持 。SSL 协 议 可 分 为 两 层 : 
SSL 记 录 协 议 (SSL Record Protocol) ， 它 建立 在 
可 靠 的 传输 协议 (如 TCP) 之 上 ， 为 高 层 协议 提 
供 数据 封闭、 压缩 、 加 密 等 基本 功能 的 文 持 。SSL 
握手 协议 (SSL Handshake Protocol) ， 它 建立 在 
SSL 记 孙 协 议 之 上 ， 用 于 在 实际 数据 传输 开始 前 ， 
通信 双方 进行 身份 认证 、 协 商 加 密 算 法 、 区 换 加 


密 密 钥 等 。 


而 在 基于 B/S 的 Web 应 用 中 ， 是 通过 HTTPS 来 
实现 SSL 的 。HTTPS 是 以 安全 为 目标 的 HTTP 通 
道 ， 人 简单 讲 是 HTTP 的 安全 版 ， 即 在 HTTP 下 加 入 
SSL 层 ，HTTPS 的 安全 基础 是 SSL ° 


因为 Spring Boot H AENA Tomcat, T 
我 们 做 SSL 配 置 的 时 候 需 要 做 如 下 的 操作 。 


1 生成 证 书 

使 用 SSL 首 先 需要 一 个 证 书 ， 这 个 证 书 既 可 以 
是 自 签 名 的 ， 也 可 以 是 从 SSL 证 书 授权 中 心 获 得 
: 。 本 例 为 了 演示 方便 ， 演 示 目 授权 证 书 的 生 

每 一 个 JDK 或 者 JRE 里 都 有 一 个 工具 叫 
keytool， 它 是 一 个 证 书 管 理工 具 ， 可 以 用 来 生成 
目 签 名 的 证 书 ， 如 图 7-11 所 示 。 


jdk1.8.0 » bin 


^ ”名称 


© jvisualvm.exe ^; kcms.dll 


[m] keytool.exe [rs keytool.exe 
[1] kinit.exe 


[1] kinit.exe 


图 7-11 keytool 
在 配置 了 JAVA_HOME， 并 将 JAVA_HOME 的 
bin 目 录 加 入 到 Path 后 ， 即 可 在 控制 台 调 用 该 命 
令 ， 如 图 7-12 所 示 。 


JAVA_HOME 


CAProgram Files\Javp\jdk1.8.0 


Path 


%-0.5.0-win64\bin;C:\Program Files\nodejs\;D:\spring-1.3.0.M1\bin;%JAVA_HOME%\bin 


确定 取消 


图 7-12 ”将 bin 目 录 加 入 到 Path 


在 控制 台 输 入 如 下 命令 ， 然 后 按照 提示 操 
作 ， 如 图 7-13 所 示 。 


keytool -genkey -alias tomcat 


ha S08 4 = £ . oT. B noe ax 
ely, O=wisely, L=hefei, ST=anhui, C=8675; 


RHE AEO SHR, 按 回 车 ) : 
新 口 今 : 


图 7-13 ”按照 提示 操作 


这 时 候 我 们 在 当前 目 永 下 生成 了 一 个 .keystore 
文件 ， 这 了 吏 是 我 们 要 用 的 证 书 文件 ， 如 图 7-14 所 
ZN ° 


RP ， wisely 


P^ edm 
| J 
| certenroll.log 


| .npmrc 
EB ch5 2 4.zip 
E$ .m2.zip 


| | keystore 


图 7-14 ”keystore 文 件 


2.Spring Boot 配 置 SSL 


tI — ^1 index.html2!|src/main/resources/static 


下 ， 作 为 测试 。 


将 .keystore 文 件 复制 到 项 目的 根 目 永 ， 然 后 在 
application.properties 中 做 如 下 SSL 的 配置 : 


server.port = 8443 
server.ssl.key-store - .keystore 


server.ssl.key-store-password- 111111 
server.ssl.keyStoreType- JKS 
server.ssl.keyAlias: tomcat 


此 时 启动 Spring Boot， 控 制 合 输出 效果 如 图 7- 
15 所 示 。 


Tomcat started on port(s): 8443 (https) 


Started Ch74Application in 2.659 seconds (JVM running for 2.957) 


Al7-15 ”控制 合 输出 效果 


此 时 访问 https:Wlocalhost: 8443， 歼 果 如 图 7- 
16 所 示 。 


; 
O f N- o |R  bupt localhost 


index page 


图 7-16 ”访问 localhost: 8443 
3.http 转 癌 https 


很 多 时 候 我 们 在 地 址 栏 输入 的 是 http ， 但 是 会 
目 动 转 癌 到 https， 例 如 我 们 访问 百度 的 时 候 ， 如 
图 7-17 所 示 。 


x 


À http://www.baidu.com 


:应 用 ”点 去 这 里 导入 书签 。 开始 


RE , 你 就 知道 x 
€ C B&B https://www.baidu.com 


图 7-17 http 上 自动 转向 https 


要 实现 这 个 功能 ， 我 们 需 配 置 
TomcatEmbeddedServletContainerFactory, Jf Hj 
JlllTomcatBÉconnector2?€ SEN, « 


这 时 我 们 需要 在 配置 文件 里 增加 如 下 配置 : 


import org.apache.catalina.Context; 

import org.apache.catalina.connector.Connector; 

import 
org.apache.tomcat.util.descriptor.web.SecurityCollection; 
import 
org.apache.tomcat.util.descriptor.web.SecurityConstraint; 
import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplication 


了 

Import 
org.springframework.boot.context.embedded.EmbeddedServletCon 
tainerFactory; 

import 
org.springframework.boot.context.embedded.tomcat.TomcatEmbed 


dedServletContainerFactory; 
import org.springframework.context.annotation.Bean; 


QSpringBootApplication 
public class Ch74Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch74Application.class, args); 


j 


QBean 
public EmbeddedServletContainerFactory 
servletContainer() ( 
TomcatEmbeddedServletContainerFactory tomcat - new 
TomcatEmbeddedServletContainerFactory() ( 
QOverride 
protected void postProcessContext(Context context) 
{ 
SecurityConstraint securityConstraint = new 
SecurityConstraint(); 


securityConstraint.setUserConstraint("CONFIDENTIAL"); 
SecurityCollection collection - new 
SecurityCollection(); 
collection.addPattern("/*"); 
securityConstraint.addCollection(collection); 
context.addConstraint(securityConstraint); 


} 
I; 


tomcat .addAdditionalTomcatConnectors(httpConnector()); 
return tomcat; 

} 

QBean 

public Connector httpConnector() ( 
Connector connector - new 

Connector("org.apache.coyote.http11.Httpi1NioProtocol"); 

connector.setScheme("http"); 
connector.setPort(8080); 
connector.setSecure(false); 
connector.setRedirectPort(8443); 
return connector; 


此 时 启动 Spring Boot， 控 制 合 输出 效果 如 图 7- 
18 所 示 。 


Tomcat started on port(s):|8443 (https) 8080 (http 


Started Ch74Application in 2.464 seconds VM running for 2.786) 


&7-18 启动 Spring Boot 


此 时 我 们 访问 : http://localhost: 8080, 2H 
动 转 到 https:/localhost: 8443， 如 图 7-19 所 示 。 


http://localhost:8080/ 


Insert title here 


tx bieps://localhost 


图 7-19 ”自动 转 到 https://localhost: 8443 


7.5 “Favicon 配 置 
7.5.1 默认 的 Favicon 


Spring Boot 提 供 了 一 个 默认 的 Favicon， 每 次 
访 回 应 用 的 时 候 都 能 看 到 ， 如 图 7-20 所 示 。 


7.5.2 ”关闭 Favicon 


我 们 可 以 在 application.properties 中 设置 关闭 
Favicon， 洽 认为 开局 ， 如 图 7-21 所 示 。 


spring.mvc.favicon.enabled=false 


| @ Insert title here x 


€ C | D localhost:8888 


index page 


图 7-20 ZB Favicon 


了 无 法 访问 http://localhos x 


& | D localhost:8888 


图 7-21 关闭 Favicon 


7.5.3 ”设置 日 已 的 Favicon 


若 需 要 设置 自己 的 Favicon， 则 只 需 将 自己 的 
favicon.ico (文件 名 不 能 变动 ) 文件 放置 在 类 路 径 
根 目 未 、 类 路 径 META-INFresources/ 下 、 类 路 径 
resources/ 下 、 类 路 径 static/ 下 或 类 路 径 publiw 下。 
这 里 将 favicon.ico 放 置 在 src/main/resources/static 


下 ， 运 行 效 末 如 图 7-22 所 示 。 


— È Insert title here x \ 


€ > CQ |[5localhost8888 


index page 


图 7-22 ”运行 效果 


7.6 WebSocket 


7.6.1 什么 是 WebSocket 


WebSocket7J 13 bh as Hk 25 inte HE SOM Lae 
HENDRE, BU ss n] Cl Ram AAI s, 
ARH ante n] CAE B; mR A X81 AS * WebSocketrzz 2l 
览 器 的 支持 ， 如 IE 10+ ^ Chrome 13+ ^ Firefox 
6+， 这 对 我 们 现在 的 浏览 絮 来 说 都 不 是 问题 。 


WebSocket 是 通过 一 个 socket 来 实现 双 工 异步 
通信 和 能力 的 。 但 是 直接 使 用 WebSocket (或 者 
SockJS: WebSocket 夫 议 的 模拟 ， 增 加 了 当 浏 哎 履 
不 文 持 WebSocket 的 时 候 的 兼容 文 持 ) 协议 开发 程 
序 显得 特别 烦琐 ， 我 们 会 使 用 它 的 子 协议 
STOMP， 它 是 一 个 更 高 级 别 的 协议 ，STOMP 协 议 
使 用 一 个 基于 帆 (frame) 的 格式 来 定义 消息 ， 与 
HTTP 的 request 和 response 类 似 (具有 类 似 于 
(@RequestMapping 的 @MessageMapping) ， 我 们 
会 在 后 面 实战 内 容 中 观察 STOMP 的 帧 。 


7.6.2 Spring Boot 提 供 的 自动 配置 


Spring Boot 对 内 骸 的 Tomcat (7 或 者 8) ` 
Jetty9 和 Undertow 使 用 WebSocket 提 供 了 支持。 了 配 
ABAT 
org.springframework.boot.autoconfigure.websocket 


下 ， 如 图 7-23 所 示 。 


bb JettyWebSocketContainerCustomizer.class 
bh TomcatWebSocketContainerCustomizer.class 
ii UndertowWebSocketContainerCustomizer.class 


ba WebSocketAutoConfiguration.class 


oy WebSocketContainerCustomizer.class 


图 7-23 ”源码 存放 位 置 


Spring Boot 为 WebSocket 提 供 的 stater pom 
spring-boot-starter-websocket ° 


7.6.3 ”实战 
1. 准 备 


STÆ Spring Boot 项 目 ， 选 择 Thymeleaf 和 
Websocket 依 顿 ， 如 图 7-24 所 示 。 


New Spring Starter Project 


Type: 
Java Version: 


Boot Version: 


Group 
Artifact 
Version 
Description 


Package 


Dependencies 


[ ]AMQP 


AWS Messaging 


ch7_6 


Maven Project v 


18 v 


com.wisely 
ch7 6 


0.0.1-SNAPSHOT 


Packaging: 


Language: 


Demo project for Spring Boot 


com.wisely.ch7 6 


AOP 
Actuator 


[C] Batch 


Cloud Bus AMQP 


Config Server 
Eureka Server 
Gemfire 
HSQLDB 
JDBC 
LinkedIn 
Mustache 
Redis 


mmmmm-mm 


f 
H 


Turbine AMQP 
ws 


[] 


L] LJ L1 L1 L1 L3 LJ 


ENNININMIE 


Bitronix (JTA) 
Cloud Connectors 
DevTools 
Facebook 
Groovy Templates 
Hystrix 

JMS 

Mail 

MySQL 

Remote Shell 

Solr 

Twitter 

Web 


AWS 
__] Apache Derby 
[ ]Cache 
Cloud Security 
[ ]Elasticsearch 
Feign 


[ ]H2 


[ ]JPA 
[ ] Mobile 
OAuth2 


[V] Thymeleaf 


[ ]Vaadin 
Websocket 


Hystrix Dashboard 


[ ]Rest Repositories 


AWS JDBC 
[ ]Atomikos UTA) 
Cloud Bootstrap 
Config Client 
Eureka 
Freemarker 
HATEOAS 
Integration 
L1 Jersey (JAX-RS) 


Ribbon 
Turbine 
[ ] Velocity 
Zuul 


图 7-24 39}%Thymeleaf#llWebsocket 


2] fx 


T EARRA tin TH AY 


HAE T 4 BfendpointH jl 53,3 


会 将 消息 发 送 给 
局 


o 


(1) 配置 WebSocket， 需 要 在 配置 类 上 使 用 
@EnableWebSocketMessageBrokerJt ri WebSocket 
文 择 ， 并 通过 继承 
AbstractWebSocketMessageBrokerConfigurerZs , Œ 
写 其 方法 来 配置 WebSocket ° 


代码 如 下 : 


package com.wisely.ch?7 6; 


import org.springframework.context.annotation.Configuration; 
import 
org.springframework.messaging.simp.config.MessageBrokerRegis 
try; 

import 
org.springframework.web.socket.config.annotation.AbstractWeb 
SocketMessageBrokerConfigurer; 

import 
org.springframework.web.socket.config.annotation.EnableWebSo 
cketMessageBroker; 

import 
org.springframework.web.socket.config.annotation.StompEndpoi 
ntRegistry; 


@Configuration 
@EnablewebSocketMessageBroker//1 

public class WebSocketConfig extends 
AbstractWebSocketMessageBrokerConfigurer { 


QOverride 
public void registerStompEndpoints(StompEndpointRegistry 
registry) ( //2 


registry.addEndpoint("/endpointWisely").withSockJS(); //3 
} 


QOverride 
public void configureMessageBroker(MessageBrokerRegistry 


registry) {//4 
registry.enableSimpleBroker("/topic"); //5 


代码 解释 


(通过 @EnableWebSocketMessageBroker 注 解 
开启 使 用 STOMP 协 议 来 传输 基于 代理 (message 
broker) NÄE, ARTIE has AFE H 
@MessageMapping, 1K 1 A @RequestMapping 


o 


(注册 STOMP 协 议 的 节点 (endpoint) , FH 
射 的 指定 的 URL © 


G@) 注 册 一 个 SIOMP 的 endpoint， 并 指定 使 用 
SockJS 协 议 。 


配置 消息 代理 (Message Broker) 。 
O RIAM Atopic) EARE o 
(2) Aaa Ta) ARS ita AC SATE A Hd DEG 26 


ONE 
X: 
package com.wisely.ch7 6.domain; 


public class WiselyMessage { 


private String name; 


public String getName(){ 
return name; 
j 


(3) 服务 端 向 浏览 如 发 送 的 此 类 的 消 乱 : 


package com.wisely.ch7_6.domain; 


public class WiselyResponse { 
private String responseMessage; 
public WiselyResponse(String responseMessage) { 
this.responseMessage = responseMessage; 
} 
public String getResponseMessage(){ 
return responseMessage; 


j 


(4) 演示 控制 器 ， 代 码 如 下 ; 


package com.wisely.ch7 6.web; 


import 
org.springframework.messaging.handler.annotation.MessageMapp 
ing; 

import 
org.springframework.messaging.handler.annotation.SendTo; 
import org.springframework.stereotype.Controller; 


import com.wisely.ch7 6.domain.WiselyMessage; 
import com.wisely.ch7 6.domain.WiselyResponse; 


@Controller 
public class WsController { 
QMessageMapping("/welcome") //1 
QSendTo("/topic/getResponse") //2 
public WiselyResponse say(WiselyMessage message) throws 


Exception { 
Thread.sleep(3000); 


return new WiselyResponse("Welcome, " + 
message.getName() + "!"); 
} 
M JJ x LX 
代码 解释 


OZA bias [Al AR in ACIS TRAY, Rao 
@MessageMapping#RAT/welcomerx THULE, Z1 
T @RequestMapping ° 


QAM Sinaia, mou I @SendTo 
FA BAS DU Vi AL XR d o 


(5) 添加 脚本 。 将 stomp.min.js (STOMPT) 
议 的 客户 端 脚本 ) 、sockjs.min.js (SockJS 的 客户 
端 脚本 ) 以 及 jQuery 放置 在 src/main/resources/static 
下 。 读 者 可 在 这 一 半 的 源码 里 找到 这 几 个 脚本 ， 
Re ATT PR 


(6) mA E 
src/main/resources/templates F39r£&ws.html, (RS 
如 下 : 


<!DOCTYPE html» 
«html xmlns:th="http://www.thymeleaf .org"> 
<head> 

<meta charset="UTF-8" /> 

<title>Spring Boot+WebSocket+ 广 播 式 </tit1le> 


«/head» 
«body onload="disconnect()"> 
<noscript><h2 style="color: #ffO000">S {LL REI Was CS 
websocket</h2></noscript> 
<div> 
<div> 
«button id="connect" onclick="connect();"> 连 接 
</button> 
<button id="disconnect" disabled="disabled" 
onclick="disconnect() "> 断 开 连接 </button> 
</div> 
<div id="conversationDiv"> 
<label> 输 入 你 的 名 字 </label><input type="text" 
id="name" /> 
«button id="sendName" onclick="sendName();"> 发 送 
</button> 
<p id="response"></p> 
</div> 
</div> 
«script th:src="@{sockjs.min.js}"></script> 
«script th:src="@{stomp.min.js}"></script> 
«script th:src="@{jquery.js}"></script> 
<script type="text/javascript"> 
var stompClient = null; 


function setConnected(connected) { 
document.getElementById('connect').disabled - 
connected; 
document.getElementById('disconnect').disabled - 
I connected; 


document.getElementById('conversationDiv').style.visibility 
- connected ? 'visible' : 'hidden'; 
$('sresponse').html(); 
} 


function connect() { 
var socket = new SockJS('/endpointWisely'); //1 
stompClient = Stomp.over(socket); //2 
stompClient.connect({}, function(frame) { //3 
setConnected(true); 
console.log('Connected: ' + frame); 
stompClient.subscribe('/topic/getResponse', 
function(respnose){ //4 


showResponse( JSON.parse(respnose.body).responseMessage); 
3); 
3); 


function disconnect() ( 
if (stompClient !- null) { 
stompClient.disconnect(); 


setConnected(false); 
console.log("Disconnected"); 


j 


function sendName() ( 
var name = $('#name').val(); 
775 


stompClient.send("/welcome", {}, JSON.stringify({ 
'name': name })); 


} 
function showResponse(message) { 
var response = $("#response"); 
response.html(message); 
«/script» 


«/body» 
</html> 


代码 解释 


连接 SockJS 的 endpoint 和 名 称 
为 “/endpointWisely”。 


0) 使 用 STOMP 子 协议 的 WebSocket 客 户 端 。 


(SEE WebSocket/H]i 45r ° 


(438i 1l stompClient.subscribet] 
阅 /topic/getResponse 目 标 (destination) 发 送 的 消 
轧 ， 这 个 是 在 控制 硕 的 @SendTo 中 定义 的 。 


人 ) 通 过 stompClient.send 回 /welcome 目 标 
(destination) 发 送 消息 ， 这 个 是 在 控制 器 的 
@MessageMapping 中 定义 的 。 


(7) 配置 viewController， 为 ws.html 提 供 便 
捷 的 路 径 映 射 : 


QConfiguration 
public class WebMvcConfig extends WebMvcConfigurerAdapter { 


QOverride 
public void addViewControllers(ViewControllerRegistry 
registry) { 


registry.addViewController("/ws").setViewName("/ws"); 


j 


(8) 运行 。 我 们 预期 的 效果 是 : 当 一 个 浏览 
器 发 送 一 个 消 轧 到 服务 端 时 ， 其 他 浏览 絮 也 能 接 
WCE MAR hig At IE PRAIA MAL 


JE = Mil bias af, JEU 
http://localhost: 8080/ws， 分 别 连 接 服务 器。 然后 
在 一 个 浏 斋 噩 中 发 送 一 条 消息 ， 其 他 浏览 右 接 收 
iH E e 


连接 服务 疾 ， 如 图 7-25 所 示 。 


- oO x 一 x - o0 x 
@ Spri x d g Spri: x g Spri: x 
C |D localhost:8(¢y = m € Q localhost:8 ze Q |[5localhost8(7?| = 
连接 | | 断 开 连 接 由 | 连接 | | 断 开 连 接 | | 连接 | | 断 开 连 接 | 
输入 你 的 名 字 | XE 输入 你 的 名 字 


inl 


图 7-25 ”连接 服务 虽 


— TNR ISA, WIÉI-26Btzm © 


= 口 x 一 口 x 一 口 x 
@ Spri: x g Spri: x @ Spri: x 
C D localhost:8(% = || € C [|5localhost8(77 = || € C | D localhost:8 三 
连接 | | 断 开 连 接 | ie ES 连接 | | 断 开 
输入 你 的 名 字 输入 你 的 名 字 输入 你 EE 
wyf| JL XE | 发 送 发 送 


图 7-26 ”发送 消息 


所 有 浏览 器 接收 服务 端 发 送 的 消息 ， 如 图 7- 
27 所 示 。 


= 口 X 一 [m] x sa 口 x 
gi Spri: x @ Spri: x ei Spri: x 
C D localhost:8(% = f| € Q 口 Ilocalhost'8(x = || € e localhost:a(sv = 
连接 | | 断 开 连接 连接 | HAR 连接 连接 | 
输入 你 的 名 字 输入 你 的 名 字 和 
wyf 发 送 发 送 
Welcome, wyf! 


Welcome, wyf! Welcome, wyf! 


图 7-27 所 有 浏览 器 接收 信息 


HA lÆ Chromel] ias (在 Chrome 下 按 F12 调 
E) 下 观察 一 下 STOMP 的 帧 ， 如 图 7-28 所 示 ° 


nfo Östa 

websocket - 
[TENE uu 
of CONNE 


图 7-28 ”观察 STOMP 的 帧 


从 上 述 截 图 可 以 观察 得 出 ， 连 接 服 务 端 的 格 
AA: 


accept-version:1.1,1.0 
heart-beat:10000, 10000 


连接 成 功 的 返回 为 : 


CONNECTED 
version:1.1 
heart-beat:0,0 


订阅 目标 (destination) /topic/getResponse: 


SUBSCRIBE 
id:sub-0 
destination: /topic/getResponse 


问 目 标 (destination) /welcome 发 送 消 息 的 格 
T 


SEND 

destination: /welcome 
content-length:14 
{\"name\":\"wyf\"} 


从 目标 (destination) /topic/getResponse 接 收 
的 格式 为 : 


MESSAGE 

destination:/topic/getResponse 
content-type:application/json;charset-UTF-8 
subscription:sub-0 

message-id:zxj4wyau-0 

content-length:35 
{\"responseMessage\":\"Welcome, wyf!\"} 


3. OG] EL, 


广播 式 有 目 已 的 应 用 场景 ， 但 十 广播 式 个 能 
解决 我 们 一 个 第 见 的 场景 ， 即 消 妃 由 谁 发 送 、 由 
谁 接收 的 问题 。 


本 例 中 演示 了 一 个 人 简单 的 聊天 宇 程序 。 例 子 
中 只 有 两 个 用 户 ， 互 相 发 送 消 忆 给 彼此 ， 因 和 需 
用 户 相 关 的 内 容 ， 所 以 先 在 这 里 引入 最 人 简单 的 
Spring Security 相 天 内 容 。 


(1) 添加 Spring Security 的 starter pom: 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter- 


security«/artifactId» 
«/dependency» 


(2) Spring Security 的 简单 配置 。 这 里 不 对 
Spring Security 做 过 多 解释 ， 只 解释 对 本 项 目 有 帮 
助 的 部 分 : 


QConfiguration 
QEnablewebSecurity 
public class WebSecurityConfig extends 
WebSecurityConfigurerAdapter( 
QOverride 
protected void configure(HttpSecurity http) throws 
Exception { 
http 
.authorizeRequests() 
.antMatchers("/","/1ogin").permitAl1()//1 
.anyRequest( .authenticated() 
.and() 
.formLogin() 
.loginPage("/login") //2 
.defaultSuccessUrl("/chat") //3 
.permitAll() 
.and() 
. Logout ( ) 
.permitAll(); 
} 


//4 
QOverride 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
auth 
.inMemoryAuthentication() 


.WithUser("wyf").password("wyf").roles("USER") 
.and() 


.WithUser("wisely").password("wisely").roles("USER"); 


//5 


QOverride 
public void configure(WebSecurity web) throws Exception 


{ 


web.ignoring().antMatchers("/resources/static/**"); 


代码 解释 
设置 Spring Security 对 /和 /login” 路 径 不 拦 
E o 


Dix E Spring Security 的 登录 页 面 访 问 的 路 径 
为 /login。 


9) 登录 成 功 后 转 同 /chat 路 径 。 


(9 在 内 存 中 分 别 配 置 两 个 用 户 wyf 和 wisely， 
密码 和 用 户 名 一 致 ， 角 色 征 USER 。 


G/resources/static/ H sk FAVE S EIR, Spring 
Security 1— £k ^ 


(3) 配置 WebSocket: 


QConfiguration 
QEnablewebSocketMessageBroker 

public class WebSocketConfig extends 
AbstractWebSocketMessageBrokerConfigurer { 


@Override 


public void registerStompEndpoints(StompEndpointRegistry 
registry) { 


registry.addEndpoint("/endpointWisely").withSockJS(); 


registry.addEndpoint("/endpointChat").withSockJS();//1 
} 


QOverride 
public void configureMessageBroker(MessageBrokerRegistry 
registry) { 
registry.enableSimpleBroker("/queue","/topic"); //2 
} 


代码 解释 
(注册 一 个 名 为 /endpointChat 的 endpoint 。 
驯 点 对 扩 式 应 增加 一 个 /queue 消 居 代 理 。 

(4) 控制 器 。 在 WsController 内 添加 如 下 代 


@Autowired 
private SimpMessagingTemplate messagingTemplate;//1 


QMessageMapping("/chat") 
public void handleChat(Principal principal, String msg) 
{ 7/2 
if (principal.getName().equals("wyf")) (//3 
messagingTemplate.convertAndSendToUser("wisely", 
"/queue/notifications", 
principal.getName() + "-send:" 
* msg); //4 
) else { 


messagingTemplate.convertAndSendToUser("wyf", 
"/queue/notifications", 
principal.getName() + "-send:" 
* msg); 
} 


} 
代码 解释 


Mt SimpMessaging Template [4] 2] bias /& 3s 
消息 。 


@ 在 Spring MVC 中 ， 可 以 直接 在 参数 中 获得 
principal, pinciple 中 包含 当 BU FH PB o 


(3) 这 里 是 一 段 硬 编码 ， 如 果 发 送 人 是 wyf， 则 
发 送 给 wisely; 如 果 发 送 人 是 wisely， 则 发 送 给 
wyf， 读 者 可 以 根据 项 目 实际 需要 改写 此 处 代码 。 


(通过 
messagingTemplate.convertAndSendToUser 回 用 户 
AJXSIH. B-TEAM EAP, B 
PEN ode] DAHL, B= SATA SANE s 

(5) 登录 页 面 。 在 


src/main/resources/templates 下 新 建 login.html， 代 
但 如 下 : 


<!DOCTYPE html» 
«html xmlns-"http://www.w3.0rg/1999/xhtm1l" 


xmlns:thz"http://www.thymeleaf.org" 
xmlns:sec-'http://www.thymeleaf.org/thymeleaf-extras- 
springsecurity3"> 
<meta charset="UTF-8" /> 
<head> 
<title> 登 录 页 面 </title> 
</head> 
<body> 
«div th:if="${param.error}"> 
无 效 的 账号 和 密码 
</div> 
«div th:if="${param.logout}"> 
你 已 注销 
</div> 
«form th:action="@{/login}" method="post"> 
<div><label> 账号 : «input type="text" name="username"/> 
</label></div> 
<div><label> 密码 : <input type="password" 
name="password"/> </label></div> 
<div><input type="submit" Value=" 登 陆 "/></div> 
«/form» 
</body> 
</html> 


(6) 聊天 页 面 。 在 
src/main/resources/templates 下 新 建 chat.htm1， 人 代码 
A P: 


<!DOCTYPE html» 


«html xmins:th="http://www.thymeleaf.org"> 
«meta charset="UTF-8" /> 
<head> 
<title>Home</title> 
<script th:src="@{sockjs.min.js}"></script> 
«script th:src="@{stomp.min. js}"></script> 
«script th:src="@{jquery.js}"></script> 
</head> 
<body> 


<p> 
聊天 室 


«/p» 


«form id="wiselyForm"> 
«textarea rows="4" cols="60" name="text"></textarea> 
«input type="Submit"/> 

</form> 


<script th:inline="javascript"> 
$('ZwiselyForm').submit(function(e)( 
e.preventDefault(); 
var text - 
$('#wiselyForm').find('textarea[name="text"]').val(); 
sendSpittle(text); 


}); 


var sock = new SockJS("/endpointChat"); //1 
var stomp = Stomp.over(sock); 
stomp.connect('guest', 'guest', function(frame) { 
stomp.subscribe("/user/queue/notifications", 
handleNotification);//2 


}); 


function handleNotification(message) { 
$('#output').append("<b>Received: " + message.body + 
"</b><br/>") 
} 


function sendSpittle(text) { 
stomp.send("/chat", {}, text);//3 


} 
$('#stop').click(function() {sock.close()}); 
</script> 


«div id="output"></div> 


</body> 
</html> 


代码 解释 


连接 endpoint 名 称 为 “endpointChat” 的 
endpoint ° 


(2T [yi] /user/queue/notifications £ 34 BJ 1H Js , 
这 里 与 在 控制 如 的 
messagingTemplate.convertAndSendToUser" 7E Y. 
的 订阅 地 址 体 持 一 致 。 这 里 多 了 一 个 /user， 并 且 
iX /userzé 4 AB, EH T /userZ RRAK SB 
指定 的 用 户 。 


(7) 增加 页 面 的 viewController: 


QConfiguration 
publicclass WebMvcConfig extends WebMvcConfigurerAdapter{ 


QOverride 

publicvoid addViewControllers(ViewControllerRegistry 
registry) { 

registry.addViewController("/ws").setViewName("/ws"); 
registry.addViewController("/login").setViewName("/login"); 


registry.addViewController("/chat").setViewName("/chat"); 


j 


(8) 运行 。 我 们 预期 的 效果 是 : 两 个 用 户 登 
KAA, PUERI E o EANA HA 
SWsessione HREAN, KITI ELE A ap a, sg 1 
置 两 个 独立 的 用 户 ， 从 而 实现 用 户 会 话 session 陋 
离 ， 如 图 7-29 所 示 。 


现在 分 别 在 两 个 用 户 下 的 浏览 硕 访 问 : 
http://localhost: 8080/login， 并 登录 ， 如 图 7-30 所 


wyfH F [i]wisely FH PRAK E, WIÉd7-31BT 


wisely H P? [A] wy£ Fg P A X1 As. AI E 7-32 PT 


«| 局 用 访客 浏览 


M 允许 任 何人 向 Chrome 添加 用 户 


SAX XI ae 
| 将 Google Chrome iX RE ISLA Me 


一 L 一 mA. £E meg TO 一 己 己 


El > 


图 7-29 两 个 独立 的 用 户 


T w 


€ > C |D localhost:8080/login 
账号 : 


密码 : 
登陆 


图 7-30 分别 登 录 


E y @ Home x Wn ERN / g Home x wl mu 
€ > C [localhost8080/chat € > QC [localhost:8080/chat R= 


聊天 室 聊天 室 


z j FT Home x \ P j & Home x N 
€ > QC [5localhost8080/chat € > ÇC [3localhost8080/chat 


聊天 室 聊天 室 


hello there! 


Received: wyf-send:hello 


图 7-32 wisely P! TH wyf Hi P^ AX 1H Js. 


7.7 ”基于 Bootstrap 和 AngularJS 的 现代 Web 应 用 


现代 的 B/S 系统 软件 有 下 面 几 个 特色 。 
1. 单 页 面 应 用 


单 页面 应 用 (single-page application， 人 简称 SPA) 指 
的 是 一 种 类 似 于 原生 客户 端 软件 的 更 流畅 的 用 户 体验 的 
页 面 。 在 单 页 面 应 用 中 ， 所 有 的 资源 (HTML ^ 
JavaScript ` CSS) 都 是 按 需 动态 加 载 到 页 面 上 的 ， 且 不 
需要 服务 端 控 制 页 面 的 转 问 。 


2. 啊 应 式 设 计 


响应 式 设计 (Responsive web design， 人 简称 RWD) 指 
的 是 不 同 的 设备 (电脑 、 平 板 、 手 机 ) 访问 相同 的 页 面 
的 时 候 ， 得 到 不 同 的 页 面 视图 ， 而 得 到 的 视图 是 适应 当 
前 屏 医 的 。 当 然 束 算 在 电脑 上 ， 我 们 通过 拖 动 浏览 硕 窒 
口 的 大 小 ， 也 能 得 到 合适 的 视图 。 


3. 数 据 导 问 


数据 导 问 是 对 于 页 面 寻 癌 而 言 的 ， 页 面 上 的 数据 区 
得 十 通过 消费 后 台 的 REST 服 务 来 实现 的 ， 而 不 十 通过 服 
务 器 泻 染 的 动态 页 面 (如 JSP) 来 实现 的 ， 一 般 数 据 交换 
使 用 的 格式 是 JSON ° 


本 将 针对 Bootstrap 和 AngularJS 进 行 快速 入 门 式 的 
引导 ， 如 需 深 入 学 习 ， 请 参考 官网 或 相关 专题 书籍 。 


7.7.1 Bootstrap 


1. 什 么 是 Bootstrap 


Bootstrap 官 方 定 义 : Bootstrap 是 开发 啊 应 式 和 移动 
优先 的 Web 应 用 的 最 流行 的 HTML、CSS、JavaScript 框 
BH o 
ZR 


BoostrapSz3J, f. AEA — ffs n] ELE BIB 
显示 你 想 要 的 视图 的 功能 。Bootstrap 还 为 我 们 提供 了 大 
量 美观 的 HTML 元 素 前 端 组 件 和 jQuery 捅 件 。 


2. 下 载 并 引入 Bootstrap 


下 载 地 址 : http://getbootstrap.com/getting-started/, 4H 
图 7-33 所 示 。 


Bootstrap 


Compiled and minified CSS, JavaScript, 
and fonts. No docs or original source files 


are included. 


Download Bootstrap 


图 7-33 ”下载 页 面 
下 载 的 压缩 包 的 目录 结构 如 图 7-34 所 示 。 


会 [e] = | Ef bootstrap-3.3.5-dist.zip\bootstrap-3.3.5-dist - 解 包 大 小 为 1.0 MB 
压缩 前 压缩 后 类 型 


名 称 
1. (上 级 目录 ) 文件 去 
| fonts 文件 去 
His 文件 去 


图 7-34 ”目录 结构 
最 简单 的 Bootstrap 页 面 模板 如 下 : 


<!DOCTYPE html» 
«html lang="zh-cn"> 
<head> 
«meta charset-'utf-8'» 
«meta http-equiv="X-UA-Compatible" content="IE=edge"> 
«meta name="viewport" content="width=device-width, initial- 


scale=1"> 
<!-- 上 面 3 个 meta 标 签 必 须 是 head 的 头 三 个 标签 ， 其 余 的 head 内 标签 在 此 3 个 之 后 


The above 3 meta tags *must* come first in the head; any other head 
content must come *after* these tags --> 
<title>Bootstrap 基 本 模板 </title> 


<!-- Bootstrap 的 CSS --> 
«link href="bootstrap/css/bootstrap.min.css" rel="stylesheet"> 


<!-- HTML5 shim 


and Respond .js 用 来 让 IE 8 支持 HTML 5 元 素 和 媒体 查询 --> 


<!--[if lt IE 9]> 
<script src 
z"js 
/html5shiv.min.js"></script> 
<script src 
="js 
/respond.min.js"></script> 


<! [endif 


]--> 
</head> 
<body> 
«hi»fKüf, Bootstrap!«/hi» 


<!-- jQuery 是 Bootstrap 脚 本 插件 必需 的 --> 
«script src="js/jquery.min.js"></script> 
<!-- 包含 所 有 编译 的 插件 - -> 
«script src="bootstrap/js/bootstrap.min.js"></script> 
«/body» 
«/html» 


3.CSS 支 持 


Bootstrap 的 CSS 样 式 为 基础 的 HTML 元 系 提 供 了 美观 
此 外 还 提供 了 一 个 高 级 的 网 格 系统 用 来 做 页 面 


(1) 布局 网 格 


在 Bootstrap 里 ， 行 使 用 的 样式 为 row， 列 使 用 col-md- 
数字 ， 此 数字 范围 为 1~12， 所 有 列 加 起 来 的 和 也 是 12， 


代码 如 下 : 


«div class="row"> 


<div 
<div 
<div 
<div 
<div 
<div 
<div 
<div 
«div 
«div 
«div 
«div 
«/div» 


class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"». 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 
class-"col-md-1"» 


«div class="row"> 


«div 
«div 
«/div» 


class="col-md-8"> 
class="col-md-4"> 


<div class="row"> 


<div 

<div 

<div 
</div> 


class="col-md-4"> 
class="col-md-4">. 
class="col-md-4">. 


<div class="row"> 


<div 
<div 
</div> 


class="col-md-6">. 
class="col-md-6">. 


.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 


col-md-1</div> 


.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 
.col-md-1</div> 


.col-md-8</div> 
.col-md-4</div> 


.col-md-4</div> 


col-md-4</div> 
col-md-4</div> 


col-md-6</div> 
col-md-6</div> 


布局 效果 如 图 7-35 所 示 


col- col- 
md-1 md-1 


col-md-8 


col-md-4 


col-md-6 


col- col- col- col- 
md-1 md-1 md-1 md-1 


col-md-4 


图 7-35 


col- col- col- 
md-1 


col-md-4 


col-md-4 


col-md-6 


col- 
md-1 


col- 
md-1 


col- 
md-1 


(2) html 元 素 


Bootstrap 为 htm]l 元 系 担 供 了 大 量 的 样式 ， 如 表单 元 
素 、 按 钮 、 图 标 等 。 更 多 内 容 请 查看 : 
http://getbootstrap.com/css/ ° 


4. D TE AF SCHSE 


”Bootstrap 为 我 人 提供 了 大 量 的 页 面 组 件 ， 包括 字体 
R` FEIE ` EMR ` ARR ` MRES, EA 
iXhttp://getbootstrap.com/components/ ° 


5.Javascript 文 持 


Bootstrap 为 我 们 提供 了 大 量 的 JavaScript 插 件 ， 包 含 
模式 对 话 框 、 标 签 页 、 提 示 、 管 告 等 ， 更 多 内 容 请 但 看 
http://getbootstrap.com/javascript/ ° 


7.7.2 AngularJS 


1. 什 么 是 AngularJS 


AngularJS 官 方 定 义 : AngularJS 是 HIML 开 发 本 应 该 
的 样子 ， 它 是 用 来 设计 开发 Web 应 用 的 。 


AngularJS 使 用 声名 式 模板 + 数据 绑 定 (类似 于 JSP、 
Thymeleaf) ~ MVW (Model-View-Whatever) ~ MVVM 
(Model-View-ViewModel) ` MVC (Model-View- 


Controller) 、 依 赖 注 入 和 测试 ， 但 是 这 一 切 的 实现 却 只 
借助 纯 客 户 端的 JavaScript ° 


HTML 一 般 是 用 来 声明 静态 页 面 的 ， 但 是 通常 情况 
DEI TREE LEE TRUST E BURN 这 也 是 我 们 很 
多 服务 闹 檬 板 引 苟 出 现 的 原因 ; 而 AngularJS 可 以 只 通过 
前 端 技术 就 实现 动态 的 页 面 。 


2. 下 载 并 引入 AngularJS 


AngularJS 下 载 地 址 : https://angularjs.org/， 如 图 7-36 
所 示 。 


Download AngularJS 


Branch | 1.4.x (stable) | 1.2.x (legacy) 9 
Build | Minified | Uncompressed Zip 9 


CDN https://ajax.googleapis.com/ajax/libs/angularjs/1.4.2/angular.min.js 
Bower bower install angular#1.4.2 
npm  npm install angular@1.4.2 


Exons Browse additional modules 


Previous Versions 
r 此 Download 


图 7-36 “下载 页 面 


最 简单 的 AngularJS 页 面 : 


<!doctype html» 
«html ng-app><!-- 1 --> 
«head» 
«script src="js/angular.min.js"></script><!-- 2 --> 
«/head» 
«body» 
«div» 
«label» :«/label» 
<input type="text" ng-model="yourName" placeholder=" 输 入 你 的 名 
字 "><1!-- 3 --> 
<hr> 


<h1> 你 好 {{yourName}}!</hi><!-- 4 --> 
«/div» 
</body> 
</html> 


代码 解释 


GOng-app 所 作 用 的 范围 是 AngularJS 起 效 的 范围 ， 本 
例 生 整个 页 面 有 效 。 


GCC) 载 入 AngularJS 的 脚本 。 

Gng-model 定 义 整个 AngularJS 的 前 端 数据 模型 ， 模 
型 的 名 称 为 yourName， 模 型 的 值 来 日 你 输入 的 值 奉 输 入 
的 值 改变 ， 则 数据 模型 值 也 会 改变 。 

(4) 使 用 {{ 模 型 名 }} 来 读 取 模型 中 的 值 。 

效果 如 图 7-37 所 示 。 


名 字 : [wisely ] 名 字 : [wf 


你 好 wisely! 你 好 wyf! 


图 7-37 运行 效果 


BEER ` PE Til as AIAG EAB RE 


我 们 对 MVC 的 概念 已 经 烂熟 于 心 了 ， 但 是 平时 的 
MVC 都 是 服务 端的 MVC， 这 里 用 AngularJS 实 现 了 纯 页 
面 端的 MVC， 即 实现 了 视图 模板 、 数 据 模型 、 代 码 控制 
的 分 离 。 

再 来 看 看 数据 绑 定 ， 数 据 绑 定 是 将 视图 和 数据 模型 
绑 定 在 一 起 。 如 采 视 几 变 了 ， 则 模型 的 值 惑 变 了 ; UD 
模型 值 变 了 ， 则 视图 也 会 跟着 改变 。 


AngularJ$S 为 了 分 离 代 码 达 到 复 用 的 效果 ， 提 供 了 一 
‘module (RH) 。 定 义 一 个 模块 需 使 用 下 面 的 代码 。 


无 依赖 模块 : 


angular.module('firstModule',[]); 


有 依赖 模块 : 


angular.module('firstModule',['moduleA', 'moduleB']); 


Baal VLA I IB CR, Mite tee) 
ng-model, ACHE? 我 们 可 以 通过 下 面 的 代码 来 定义 控制 
as, DB fS Hing-controller2E 4135 A: EX: 


angular.module('firstModule',[]) 
.controller('firstController',function()( 


}; 
); 


«div ng-controller="firstController"> 


</div> 
4.Scope 和 Event 
(1) Scope 


Scope 是 AngularJS 的 内 置 对 象 ， 用 $Scope 来 获得 。 在 
Scope 中 定义 的 数据 是 数据 模型 ， 可 以 通过 {{ 模 型 名 上 在 
视图 上 获得 。Scope 主 要 是 在 编码 中 需要 对 数据 模型 进行 
处 理 的 时 候 使 用 ，S$cope 的 作用 范围 与 在 页 面 声明 的 范围 
一 致 〈 如 在 controller 内 使 用 ，scope 的 作用 范围 是 页 面 声 
明 ng-controller 标 签 元 素 的 作用 范围 ) 。 


EX: 


$scope.greeting-'Hello' 
se 
获取 : 

{{greeting}} 


(2) Event 


KK Scope STE ARIZ HANA], Br EA ASTI Scope Z |] 
A A ae i SBE (Event) 来 完成 。 


1) 冒 泡 事件 (Emit) 冒 泡 事件 负责 从 子 Scope 回 上 
发 达 事 件 ， 示 例如 下 。 


了 于 Scope 发 送 : 


$scope.$emit('EVENT NAME EMIT ', 'message'); 


父 Scope 接 受 : 


$scope.$on(''EVENT NAME EMIT', function(event, data) { 


3) 


2) 广播 事件 (Broadcast) 。 广 播 事 件 负责 从 父 
Scope 回 下 发 送 事件 ， 示 例如 下 。 


父 Scope 发 送 : 


$scope.$broadcast('EVENT NAME BROAD ', 'message'); 


子 scope 接 受 


$scope.$on(''EVENT NAME BROAD', function(event, data) { 


3) 


5. 多 视图 和 路 由 

多 视图 和 路 由 是 AngularJS 实 现 单 页 面 应 用 的 技术 天 
键 ，AngularJS 内 置 了 一 个 $routeProvider 对 象 来 负责 页 面 
加 载 和 页 面 路 由 转 回 。 


需要 注意 的 是 ，1.2.0 之 后 的 AngularJS 将 路 由 功能 移 
出 ， 所 以 使 用 路 由 功能 要 为 外 引入 angular-route.js 


例如 : 


angular.module('firstModule').config(function($routeProvider) { 
$routeProvider.when('/view1', { //1 
controller: 'Controlleri1', //2 
templateUrl: 'viewi.html', //3 
}).when('/view2', ( 
controller: 'Controller2', 
templateUrl: 'view2.html', 


}); 
}) 


代码 解释 

此 处 定义 的 是 某 个 页 面 的 路 由 名 称 。 

GO 此 处 定义 的 是 当前 页 面 使 用 的 控制 套 。 

(3 此 处 定义 的 要 加 载 的 真实 页 面 。 

在 页 面 上 可 以 用 下 面 代码 来 使 用 我 们 定义 的 路 由 : 


«ul» 
<li><a href="#/view1">view1</a></li> 
<li><a href="#/view2">view2</a></1li> 
</ul> 
<ng-view></ng-view> «!-- 此 处 为 加 载 进来 的 页 面 § 


1 示 的 位 置 - -> 


6. 依 赖 注入 


依赖 注入 是 AngularJS 的 一 大 酷 炫 功能 。 可 以 实现 对 
代码 的 解 厢 ， 在 代码 里 可 以 注入 AngularJS 的 对 象 或 者 我 
们 目 定 义 的 对 象 。 下 面 示例 是 在 控制 妖 中 注入 $scope， 
注意 使 用 依赖 注入 的 代码 格式 。 


angular.module('firstModule') 
.controller("diController", ['$scope', 
function ($scope) { 


31); 


7.Service 和 Factory 


AngularJS 为 我 们 内 置 了 一 些 服务 ， 如 $location ^ 
$timeout、$rootScope 〈 请 读者 自行 学 习 相 关 的 知识 ) 。 
很 多 时 候 我 们 需要 目 己 定制 一 些 服 务 ，AngularJS 为 我 们 
提供 了 Service 和 Factory ° 


Service 和 Factory 的 区 别 是 : 使 用 Service 的 话 ， 
AngularJS 会 使 用 new 来 初始 化 对 象 ， 而 使 用 Factory 会 
接 获 得 对 象 。 


(1) Service 


nota 


angular.module('firstModule').service('helloService',function()( 
this.sayHello=function(name) { 
alert('Hello '+name); 
} 
3); 


注入 调用 : 


angular.module('firstModule') 
.controller("diController", ['$scope', 'helloService', 
function ($scope,helloService) ( 
helloService.sayHello('wyf'); 
31); 


(2) Factory 


EX: 


angular.module('firstModule').service('helloFactory',function()( 
return( 
sayHello:function(name)([ 
alert('Hello '+name); 
} 


} 
}); 


注入 调用 : 


angular.module('firstModule') 
.controller("diController", ['$scope', 'helloFactory', 
function ($scope, helloFactory) ( 
helloFactory.sayHello('wyf'); 
31); 


8.http 操 作 
AngularJS 内 置 了 $http 对 象 用 来 进行 Ajax 的 操作 : 


$http.get(url) 
$http.post(url,data) 
$http.put(url,data) 
$http.delete(url) 
$http.head(url) 


9. 目 定义 指令 


AngularJS 内 置 了 大 量 的 指令 (directive) ， 如 ng- 
repeat、ng-show、ng-model 等 。 即 使 用 一 个 人 简短 的 指令 可 
实现 一 个 前 端 组 件 。 


比方 说 ， 有 一 个 日 期 的 jyjQuery 揪 件 ， 使 用 
AngularJS 封 装 后 ， 在 页 面 上 调用 此 揪 件 可 以 通过 指令 来 
实现 ， 例 如 : 


<date-picker></date-picker> 

: <input type="text" date-picker/> 

: <input type="text" class="date-picker"/> 
: <!--directive:date-picker--> 
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定义 指令 : 


angular.module('myApp',[]).directive('helloworld', function() { 
return { 

restrict: 'AE',// 支 持 使 用 属性 、 元 素 

replace: true, 

template: '<h3>Hello, World!</h3>' 


}; 
}); 


VASES, RNE: 


«hello-world/» 


«hello:world/» 


或 者 属性 方式 : 


«div hello-world /> 


7.7.3 ”实战 


在 表面 两 万， 我 们 快速 介绍 了 Bootstrap 和 
AngularJS， 本 太 我 们 将 它们 和 Spring Boot ERMA A 


在 例子 中 ， 我 们 使 用 Bootstrap 制 作 导 航 ， 使 用 
AngularJS 实 现 导航 切换 页 面 的 路 由 功能 ， 并 演示 


AngularJS 通 过 $http 服 务 和 Spring Boot 提 供 的 REST 服 务 ， 
最 后 演示 用 指令 封装 jQuery UI 的 日 期 选择 器 。 


1.391 && Spring Boot 项 目 


初始 化 一 个 Spring Boot 项 目 ， 依 赖 只 需 选 择 Web 
(spring-boot-starter-web) 。 


项 H 信息 : 


groupId: com.wisely 
arctifactId:ch7_7 
package: com.wisely.ch7_7 


准备 Bootstrap、AngularJS、jQuery、jQueryUI 相 天 的 
资源 到 src/main/resources/static F ， 结 构 如 图 7-38 所 示 。 


4 BE src/main/resources 
4 [ static 
4 © bootstrap 
> (E css 
> & fonts 
P & js 
4 © jqueryul 
> [5 images 
jquery-ui.min.css 
jquery-ui.min.js 
4 (> Js 


angular-route.min.js 
angular.min.js 
html5shiv.min.js 
jquery.min,js 
respond.min,js 


图 7-38 ”结构 


男 外 要 说 明 的 是 ， 本 例 的 页 面 都 是 静态 页 面 ， 所 以 
全 部 放置 在 /static 目 录 下 。 


2. 制 作 导 航 


页 面 位 置 : src/main/resources/static/action.html: 


<!DOCTYPE html» 

«html lang="zh-cn" ng-app="actionApp"> 

<head> 

«meta charset="utf-8"> 

<meta http-equiv="X-UA-Compatible" content="IE=edge"> 

«meta name="viewport" content="width=device-width, initial-scale=1"> 
<title> 实 战 </title> 


«link href="bootstrap/css/bootstrap.min.css" rel="stylesheet"> 
«link href="jqueryui/jquery-ui.min.css" rel="stylesheet"> 
«style type="text/css"> 


.content { 
padding: 100px 15px; 
text-align: center; 


j 
«/style» 


<!--[if lt IE 9]> 
«script srcz"js/html5shiv.min.js"»«/script» 
«script src="js/respond.min.js"></script> 
«I[endif]--» 
«/head» 
<body> 
<!-- 1 --> 
«nav class="navbar navbar-inverse navbar -fixed-top"> 
<div class="container"> 


«div id="navbar" class="collapse navbar -collapse"> 
<ul class="nav navbar-nav"> 
<li><a href="#/oper">ja 8% H«/a»«/li» 
<li><a href="#/directive"> 自 定义 指令 </a></1i> 
«/ul» 
«/div» 
«/div» 
«/nav» 


«1-- 2 --> 
<div class="content"> 
<ng-view></ng-view> 
</div> 
«1-- 3 --> 
<script src="js/jquery.min.js"></script> 
<script src="jqueryui/jquery-ui.min.js"></script> 
<script src="bootstrap/js/bootstrap.min.js"></script> 
<script src="js/angular.min.js"></script> 
«script src="js/angular-route.min.js"></script> 
<script src="js-action/app.js"></script> 


«script src="js-action/directives.js"></script> 
«script src="js-action/controllers.js"></script> 
«/body» 
</html> 


代码 解释 


GD 使 用 Bootstrap 定 义 的 导航 ， 并 配合 AngularJS 的 路 
由 ， 通 过 路 由 名 称 圾 oper 和 圾 directive 切 换 视 图 ; 


@) 通 过 <ng-view><mmg-view> 展 示 载 入 的 页 面 。 


(3) 加 载 本 例 所 需 的 脚本 ， 其 中 jquery-ui.min.js 的 脚本 
是 为 我 们 定制 指令 所 用 ; app.js 定 义 AngularJS 的 模块 和 路 
由 ; directives.js 为 目 定 义 的 指令 ;，controllers.js 是 控制 器 
定义 之 处 。 


3. 模 块 和 路 由 定义 
页 面 位 置 : src/main/resources/static/js-action/app.js: 


var actionApp = angular.module('actionApp',['ngRoute']); //1 


actionApp.config(['S$routeProvider' , function($routeProvider) {//2 
$routeProvider.when('/oper', ( //3 
controller: 'ViewiController', //4 
templateUrl: 'views/view1.html', //5 
}).when('/directive', { 
controller: 'View2Controller', 
templateUrl: 'views/view2.html', 
3); 
3D; 


代码 解释 
QD 定义 模块 actionApp， 并 依赖 于 路 由 模块 ngRout 。 


@ 配 置 路 由 ， 并 注入 $routeProvider 来 配置 。 
@/oper 为 路 由 名 称 。 
@controller 定 义 的 是 路 由 的 控制 器 名 称 。 
@templateUrl 定 义 的 是 视图 的 真正 地 址 。 
4. 控 制 器 定义 


脚本 位 置 : src/main/resources/static/js- 
action/controllers.js: 


//1 
actionApp.controller('ViewiController', ['$rootScope', '$scope', 
'$http', function($rootScope, $scope,$http) { 

//2 


$scope.$on('$viewContentLoaded', function() { 
console. log(' 页 面 加 载 完 成 ' ) ; 
3); 
//3 
$scope.search = function(){//3.1 
personName - $scope.personName; //3.2 
$http.get('search',( //3.3 
params: {personName: personName}//3.4 
}).success(function(data){ //3.5 
$scope.person=data; //3.6 
3); 


3195 


actionApp.controller('View2Controller', ['$rootScope', '$scope', 
function($rootScope, $scope) { 
$scope.$on('$viewContentLoaded', function() { 
console. log(' 页 面 加 载 完 成 ' ) ; 
3); 
31); 


代码 解释 


定义 控制 右 View1Controller， 并 注入 $rootScope、 
$scope 和 $http ° 


@) 使 用 $scope.$on 监 听 $viewContentLoaded 事 件 ， 可 
以 在 页 面 内 容 加 载 完 成 后 进行 一 些 操 作 。 


(3) 这 段 代码 是 这 个 演示 的 核心 代码 ， 请 结合 下 面 的 
Viewl 的 界面 一 起 理解 : 


。 在 scope 内 定义 一 个 方法 search， 在 页 面 上 通过 ng-click 
调用 。 

。 通 过 $scope.personName 获 取 页 面 定义 的 ng- 
model=“personName” 的 值 。 

。 使 用 $http.get 回 服务 端 地 址 search 发 送 get 请 求 。 

。 使 用 params 增 加 请 求 参数 。 

。 用 Success 方法 作为 请 求 成 功 后 的 回调 。 

。 将 服务 端 返 回 的 数据 data 通 过 $scope.person 赋 给 模型 
person， 这 样 页 面 视图 上 可 以 通过 {{person.name}}、 
{{fperson.age}}+、{{person.address}} 来 调用 ， 且 模型 
personae, MAGA DEBT ° 


5.View1 的 界面 (演示 与 服务 端 区 互 ) 
HAME: 


src/main/resources/static/views/view 1.html ° 


«div class="row"> 
«label for="attr" class="col-md-2 control-label'"»4fj«/label» 
«div class="col-md-2"> 
< NES 
«input type="text" class="form-control" ng-model="personName"> 


</div> 
<div class="col-md-1"> 
E EE 


«button class="btn btn-primary" ng-click-"search()"»£if«/button» 
«/div» 
«/div» 


«div class="row"> 
<div class="col-md-4"> 
«ul class="list-group"> 


Ses 3 ww 

«li class="list-group-item">4¥: {{person.name}}</1li> 
«li class="list-group-item">i#: {{person.age}}</li> 
«li class="list-group-item">shit: {{person.address}} 

</li> 
</ul> 
</div> 
</div> 


代码 解释 

定义 数据 模型 ng-model=“personName”。 

@ 通 过 ng-alick=“search O “调用 控制 器 中 定义 的 方 
法 。 


G) 通 过 { {person.name}} ^ {{person.age}} > 
{{person.address}} 访 问 控 制 妖 的 scope 里 定义 的 person 模 
型 ， 模 型 和 视图 是 绑 定 的 。 


6. 服 务 端 代码 
传 值 对 象 Javabean: 


package com.wisely.ch7 7; 


public class Person { 
private String name; 
private Integer age; 
private String address; 


public Person() { 
super(); 


public Person(String name, Integer age, String address) { 
super(); 

this.name - name; 

this.age - age; 

this.address - address; 


} 


public String getName() { 
return name; 


public void setName(String name) { 
this.name - name; 


} 


public Integer getAge() { 
return age; 


public void setAge(Integer age) { 
this.age = age; 


} 
public String getAddress() { 
return address; 


public void setAddress(String address) { 
this.address = address; 


} 


Pell ae 


package com.wisely.ch7_7; 


import 
import 
import 
import 
import 


org. 
org. 
.springframework.http.MediaType; 


org 


org. 
org. 


springframework.boot.SpringApplication; 
springframework.boot.autoconfigure.SpringBootApplication; 


springframework.web.bind.annotation.RequestMapping; 
springframework.web.bind.annotation.RestController; 


QRestController 
@SpringBootApplication 
public class Ch77Application { 


@RequestMapping(value="/search", produces= 
{MediaType .APPLICATION_JSON_VALUE}) 
public Person search(String personName) { 


return new Person(personName, 32, "hefei"); 


} 


public static void main(String[] args) { 
SpringApplication.run(Ch77Application.class, args); 


代码 解释 


这 里 我 们 只 是 模拟 一 个 查询 ， 即 接受 前 台 传 入 的 
personName， 然 后 运 回 Person 类 ， 因 为 我 们 使 用 的 是 
@RestController， 且 返回 值 类 型 是 Person， 所 以 Spring 
MVC 会 目 动 将 对 象 输出 为 JSON 。 


7. 目 定义 指令 


RAIA E src/main/resources/static/js- 
action/directives.js: 


actionApp.directive('datePicker',function()(//1 
return { 
restrict: 'AC', //2 
link:function(scope,elem,attrs) ( //3 
elem.datepicker();//4 
} 


}; 
}); 


代码 解释 
(定义 一 个 指令 名 为 datePicker ° 
限制 为 属性 指令 和 样式 指令 。 


G) 使 用 link 方 法 来 定义 指令 ， 在 link 方 法 内 可 使 用 当 
Bilscope ^ 4 BI[7C 28 X 7628 IER TE © 


(4) 初 始 化 jqueryui 的 datePicker (jquery 的 写法 是 $ 
(‘#id’) .datePicker () ) œ 


8E EAS Bel ILE | T T 315 jqueryuiff 
datePicker8 m , AIAN FiBCRBJEB, SEALY AB 
AED ERIS NUR TARA Din 
http:/ngmodules.org/ 网 站 ， 这 个 网 站 包含 了 大 量 
AngularJ$S 的 第 三 方 模块 、 插 件 和 指令 。 


8.View2 的 页 面 (演示 目 定 义 指令 ) 


页 面 地 址 : 


src/main/resources/static/views/view2.html : 


«div class="row"> 
«label for="attr" class="col-md-2 control-label"> 属 性 形式 </label> 
<div class="col-md-2"> 
gles 1 >=> 
<input type="text" class="form-control" date-picker> 
</div> 
</div> 


<div class="row"> 
«label for="style" class="col-md-2 control-label"> 样 式 形式 </label> 
<div class="col-md-2"> 


«1-- 2 --> 
<input type="text" class="form-control date-picker" > 
</div> 
</div> 


代码 解释 
使 用 属性 形式 调用 指令 。 


@) 使 用 样式 形式 调用 指令 。 
9. 运 行 
3c HN ERE EH A E] 7-39 Pr ZR. ° 


E Q | D localhost:8080/acti 


€ e localhost:8080/a 


属性 形式 
样式 形式 


图 7-39 SKE PR Ac He 
与 后 台 交 互 如 图 7-40 所 示 。 


€ C | D localhost8080/action.htmlst/oper 


名 称 = 
名 字 : wf 
年 龄 : 32 
地 址 : hefei 


图 7-40 ”与 后 台 交 


自 定义 指令 如 图 7-41 所 示 。 


Ce 
AP 


H 


c 


localhost:8080/action.html£/dire 


属性 形式 
样式 形式 | ï 
o July 2015 o 
Su Mo Tu We Th Fr Sa 
1 2 3 4 
5 6 8 9| 10) 11 
12| 13| 14 15| 16| 17| 18 
19| 20| 21| 22| 23| 24) 25 
26| 27, 28 29, 30| 31 
Al7-41 目 定 义 指令 


第 8 章 Spring BootH Z8 lal 


Spring Data 项 目 是 Spring 用 来 解决 数据 访问 问 
题 的 一 折子 解决 方案 ，Spring Data 是 一 个 作 形 项 
H, OS TKR ABA RIERA ae 
e 问 解 决 方案 。Spring Data 使 我 们 可 以 快 
= an Si 普通 的 数据 访问 技术 及 狐 的 数据 
5 |H 


Spring Data 包 舍 的 子 项 目 如 和 8-1 所 示 。 


表 8-1 SpringData 包 括 的 子 项 目 


项 目 名 称 Maven 坐标 
Spring Data JPA <dependency> 
<groupId>org.Springframework.data</groupId> 


<artifactId>spring-data-jpa</artifactId> 
<version>1.8.1.RELEASE</version> 
</dependency> 
Spring Data MongoDB <dependency> 


<groupld>org.springframework.data</groupId> 
<artifactId>spring-data-mongodb</artifactId> 
<version>1.7.1.RELEASE</version> 

</dependency> 

Spring Data Neo4J <dependency> 
<groupId>org.springframework.data</groupId> 
<artifactId>spring-data-neo4j</artifactId> 
<version>3.3.1.RELEASE</version> 

</dependency> 


项 目 名 称 
Spring Data Redis 


续 表 
Maven 坐标 
<dependency> 
<groupld>org.springframework.data</groupld> 
<artifactId>spring-data-redis</artifactId> 
<version>1.5.1.RELEASE</version> 
</dependency> 


Spring Data Solr 


<dependency> 
«groupld»org.springframework.data«/groupId» 
«artifactId»spring-data-solr«/artifactId» 
<version>1.4.1.RELEASE</version> 
</dependency> 


Spring Data Hadoop 


<dependency> 
<groupId>org.springframework.data</groupId> 
«artifactId»spring-data-hadoop«/artifactId» 
<version>2.2.0.RELEASE</version> 


</dependency> 


Spring Data GemFire 


Spring Data REST 


Spring Data JDBC Extensions 


<dependency> 
«groupld»org.springframework.data«/groupld» 
«artifactId spring-data-gemfire </artifactld> 
«version»1.6. I. RELEASE </version> 

</dependency> 

<dependency> 
<groupId>org.springframework.data</groupId> 
«artifactId»spring-data-rest-webmvc«/artifactId» 
<version>2.3.1.RELEASE</version> 

</dependency> 

<dependency> 
<grouplId>org.springframework.data</groupId> 
«artifactId»spring-data-oracle«/artifactId» 
«version»1.1.0.RELEASE«/version» 


</dependency> 


Spring Data CouchBase 


<dependency> 
<groupId>org.springframework.data</groupId> 
«artifactId»spring-data-couchbase«/artifactId» 
<version>1.3.1.RELEASE</version> 


</dependency> 


项 目 名 称 Maven 坐标 


Spring Data Elasticsearch <dependency> 


«groupld»org.springframework.data«/groupId» 

«artifactId»spring-data-elasticsearch«/artifactId 

<version>1.2.1.RELEASE</version> 
</dependency> 


Spring Data Cassandra <dependency> 
<groupId>org.springframework.data</groupId> 
«artifactId»spring-data-cassandra«/artifactId 


<version>1.2.1.RELEASE</version> 


Spring Data DynamoDB <repository> 


«artifactId»spring-data-dynamodb«/artifactId 
«version»1.0.2.RELEASE«/version» 


</dependency> 


Spring Data 为 我 们 使 用 统一 的 API 来 对 上 述 的 
数据 存储 拉 术 进行 数据 访问 控 作 提供 了 文 持 。 这 
是 Spring 通过 提供 Spring Data Commons 项 目 来 实 
现 的 ， 它 是 上 壕 各 种 Spring Data 项 目的 依赖 。 
Spring Data Commons 让 我 们 在 使 用 天 系 型 或 非 天 
系 型 数据 访问 技术 时 都 使 用 基于 Spring 的 统一 标 
准 ， 该 标准 包含 CRUD (BUS > FRAC > HT» A 
ER) 、 查 询 、 排 上 序 和 分 页 的 相关 的 操作 。 


此 处 介绍 下 Spring Data Commons 的 一 个 重要 
概念 : Spring Data Repository 抽 象 。 使 用 Spring 
Data Repository P] 以 极 大 地 减少 数据 访问 层 的 代 
人 码 。 有 既然 是 数据 访问 操作 的 统一 标准 ， 那 肯定 是 


定义 了 各 种 各 样 和 数据 访问 相关 的 接口 ，Spring 
Data Repository 抽 和 象 的 根 返 口 是 Repository 接 口 : 


package org.springframework.data.repository; 
import java.io.Serializable; 
public interface Repository<T, ID extends Serializable> { 


从 源码 中 可 以 看 出 ， 它 接受 领域 类 (JPA 为 
实体 类 ) 和 领域 类 的 id 类 型 作为 类 型 参数 。 


它 的 子 接口 CrudRepository 定 义 了 和 CRUD 探 
作 相 天 的 内 容 : 


package org.springframework.data.repository; 
import java.io.Serializable; 
QNoRepositoryBean 
public interface CrudRepository<T, ID extends Serializable> 
extends Repository<T, ID» { 
«S extends T» S save(S entity); 
«S extends T» Iterable<S> save(Iterable<S> entities); 
T findOne(ID id); 
boolean exists(ID id); 
Iterable<T> findAll(); 
Iterable<T> findAll(Iterable<ID> ids); 
long count(); 
void delete(ID id); 
void delete(T entity); 
void delete(Iterable<? extends T> entities); 
void deleteAll(); 


CrudRepositoryA F $% O 
PagingAndSortingRepository 定 义 了 与 分 页 和 排序 


操作 相关 的 内 容 : 


package org.springframework.data.repository; 
import java.io.Serializable; 

import org.springframework.data.domain.Page; 
import org.springframework.data.domain.Pageable; 
import org.springframework.data.domain.Sort; 


QNoRepositoryBean 
public interface PagingAndSortingRepository<T, ID extends 
Serializable» extends CrudRepository<T, ID» { 

Iterable<T> findAll(Sort sort); 

Page<T> findAll(Pageable pageable); 


不 同 的 数据 访问 技术 也 提供 了 不 同 的 
Repository， 如 Spring Data JPA 有 JpaRepository ^ 
Spring Data MongoDB/H MongoRepository 。 


Spring Data 项 目 还 给 我 们 提供 了 一 个 激动 人 
心 的 功能 ， 即 可 以 根据 属性 名 进行 计数 、 删 除 ^ 
查询 方法 等 操作 ， 例 如 : 


public interface PersonRepository extends 
Repository<Person, Long» ( 

// 按 照 年 龄 计数 

Long countByAge(Integer age); 

// 按 照 名 字 删 除 

Long deleteByName(String name); 

// 按 照 名 字 查 询 

List<Person> findByName(String name); 

// 按 照 名 字 和 地 址 查询 

List<Person> findByNameAndAddress(String name,String 
address); 


j 


我 们 将 在 8.2 和 对 Spring Data 提 供 的 简化 数据 
访问 探 作 进 行 更 为 评 细 的 讲解 。 


本 章 将 学 习 Spring Data JPA ` Spring Data 
MongoDB ^ Spring Data REST ^ Spring Data 
Redis。 通 过 对 这 些 Spring Data 项 目的 学 习 ， 并 按 
Fa Spring Data 提 供 的 统一 标准 ， 当 你 有 需要 的 时 
候 ， 也 会 快速 掌握 Spring Data 的 其 他 项 目 。 


8.1 引入 Docker 


大 家 也 许 很 奇怪 为 什么 本 书 在 此 处 要 引入 
Docker，Docker 究 竟 是 什么 ， 它 能 干什么 ? 


DockeriX PA EK Vib, KOEL ° Docker 
是 一 个 轻 量 级 容 硕 技术 ， 类 似 于 虚拟 机 技术 
(xen ^ kvm ^ vmware ` virtual) 。Docker 是 直接 
运行 在 当前 操作 系统 (Linux) 之 上 ， 而 不 是 运行 
在 虚拟 机 中 ， 但 是 也 实现 了 虚拟 机 技术 的 资源 隔 
离 ， 性 能 远 远 高 于 虚拟 机 技术 。 


Docker 文 持 将 软件 编译 成 一 个 镜像 

(image) ， 在 这 个 镜像 里 做 好 对 软件 的 各 种 配 
置 ， 然 后 发 布 这 个 镜像 ， 使 用 者 可 以 运行 这 个 镜 
像 ， 运 行 中 的 镜像 称 之 为 容器 (container) , 7 
希 的 局 动 是 非 彰 快 的 ， 一 般 都 是 以 秒 为 单位 。 这 
个 有 点 像 我们 平时 安 猴 ghost 操作 系统 ?系统 安 闻 
好 后 软件 都 有 了 了， 虽然 完 全 不 是 一 种 东西 ， 但 是 
思路 是 类 似 的 。 


目前 各 大 主流 云 计算 平 台 都 支持 Docker 容 器 
技术 ， 包 括 阿 里 云 、 百 度 云 平台 (资源 隔离 通过 


Docker 实 现 ) ` Cloud Foundry 《和 Spring 一 家 公 
司 的 ， 目 前 最 成 熟 也 最 稳定 ) 、HeroKu、 
DigitalOcean ` OpenShift (JBoss 的 ) ^ Apache 
Stratos ` Apache MesOS ( 批 处 理 平台 ， 支 持 搭 建 
基于 Docker 的 云 平 台 ) ^Deis (开源 PaaS 平 

台 ) ; 连 微软 也 会 在 下 一 个 版 本 的 Windows 
Server 及 其 云 平台 Azure 上 文 择 Docker， 这 样 看 来 
Docker 大 有 统一 云 计 算 的 趋势 。 


这 里 的 云 计 算 平 台 一 般 指 的 是 Paas (平台 即 
服务 ) ， 它 是 一 个 这 样 的 云 计 算 : 平台 提供 了 存 
储 、 数 据 库 、 网 络 、 负 和 载 均衡 、 目 动 扩展 等 功 
能 ， 你 只 需 将 你 的 程序 交 给 云 计 算 平 台 就 可 以 
了 。 你 的 程序 可 以 是 用 不 同 的 编程 语言 开发 的 ， 
而 使 用 的 Docker 的 云 计 算 平 台 束 是 用 Docker 来 实 
现 以 上 功能 及 不 同 程序 之 间 的 隔离 的 。 


目前 主流 的 软件 以 及 非 主流 的 软件 大 部 分 痢 
有 人 将 其 封装 成 Docker 镜 像 ， 我 们 只 需 下 载 
Docker 镜 像 ， 然 后 运行 镜像 吏 可 以 快速 获得 已 做 
好 配置 可 运行 的 软件 。 


从 本 章 开 始 ， 我 1 站 的 数据 库 将 使 用 Oracle 
XE、 需 安装 Redis 作 为 缓存 和 NoSQL 数 据 库 的 演 
示 、 需 安装 MongoDB 进 行 NoSQL 数 据 库 演 示 。 


在 第 9 章 需 要 安装 ActiveMQ 以 及 RabbitMQ 进 
行 异 步 消 息 的 演示 。 在 第 10 半 我 们 会 演示 基于 
Docker 的 Spring Boot 的 部 署 。 使 用 Docker 后 我 们 
将 不 用 手动 下 载 、 安 效 和 配置 这 些 软 件 。 


另外 要 特别 指出 的 是 ，Docker 并 不 是 为 开发 
测试 方便 而 提供 的 小 工具 ， 而 是 可 以 用 于 实际 生 
产 环境 的 一 种 极 好 的 部 车 方式 。 


当然 ， 如 采 你 锅 得 目前 没有 迫切 学 习 Docker 
的 必要 ， 可 以 略 过 此 节 ， 并 目 行 下 载 安 儿 本 书 示 
例 中 所 需要 的 软件 ， 不 过 这 么 傈 单 易 用 的 技术 还 
征 强 烈 建议 学 习 一 下 。 


当然 ， 本 书 中 涉及 的 Docker 内 容 主要 是 为 了 
方便 我 们 开发 测试 所 需 安装 的 软件 ， 不 会 涉及 
Docker 所 有 的 内 容 ， 当 然 也 不 失 于 学 习 Docker 入 
门 的 好 材料 。 通 过 学 习 本 书 的 Docker 内 容 ， 可 以 
快速 入 门 Docker， 然 后 按照 目 己 的 需求 看 是 否 需 
要 继续 深入 学 习 。 


8.1.1 Docker 的 安装 


因为 Docker 的 运行 原理 是 基于 Linux 的 ， 所 以 
Docker 只 能 在 Linux 下 运行 。 不 要 紧张 ， 这 只 能 说 


明 在 真正 的 生产 环 万 下， 基于 Docker 的 部 署 只 能 
在 Linux 上 ， 但 是 我 们 在 开发 测试 的 时 候 ，Docker 
是 可 以 在 Windows 以 及 Mac OS X 系 统 下 的 ， 运 行 
的 原理 是 启动 一 个 VirtualBox 虚 拟 机 ， 在 此 虚拟 机 
里 运行 Docker 。 


1.Linux 下 安装 
CentOS 安 装 命令 . 


sudo yum update 
sudo yum install docker 


Ubuntu: 


sudo apt-get update 
sudo apt-get docker.io 


2.Windows 下 安装 


Windows 下 运行 Docker 是 通过 这 个 
Boot2Docker 了 这 个 软件 来 实现 的 ， 这 个 软件 包含 了 
一 个 VirtualBox。 在 Windows 下 的 Docker 只 适 AF 
开发 测试 ， 不 适合 于 生产 环境 。 


Boot2Docker 下 载 地 址 : 
https://github.com/boot2docker/windows- 
installer/releases/latest ° 


因 在 Windows 下 运行 的 Docker 古 基于 
VirtualBox 虚 拟 机 软件 ， 因 此 在 安装 前 请 确认 电脑 
的 BIOS 设 置 中 的 CPU 虚 拟 化 技术 文 持 已 经 开局 。 


在 我 们 目前 测试 的 版 本 (1.7.0) F, 
Boot2Docker£?T AY ^ 3: Windows 10 系 统 。 


双击 docker-install.exe 开 始 安装 ， 如 图 8-1 所 
示 o 
@ Setup - Boot2Docker for Windows |c | mee) 


Select Destination Location 
Where should Boot2Docker for Windows be installed? 


docker 


k Setup will install Boot2Docker for Windows into the following folder. 


To continue, dick Next. If you would like to select a different folder, click Browse. 


Browse... 


Atleast 1.4 MB of free disk space is required. 


Boot2Docker for Windows installation documentatig a Let.) [cancel] 


图 8-1 开始 安装 


选择 完整 安装 ， 其 中 ，MSYS-git UNIX tools 
是 在 Windows 下 运行 UNIX (Linux) 命令 的 工 


具 ， 如 图 8-2 所 示 。 


@ Setup - Boot2Docker for Windows mum 


Select Components 
Which components should be installed? 


docker 


Select the components you want to install; dear the components you do not want to 
install. Click Next when you are ready to continue. 


Docker Client for Windows 
Boot2Docker management tool and ISO 
VirtualBox 

MSYS-git UNIX tools 


Current selection requires at least 140.6 MB of disk space. 


Boot2Docker for Windows installation doceri timidi 


图 8-2 ”完整 安装 


^4] *Reboot Windows at end of installation 
(选择 安装 完成 后 重启 电脑 ) * 选 项 ， 如 图 8-3 所 


^ 


| 


N 


Éi Setup - Boot2Docker for Windows M NE ee c=- 
ven 
Select Additional Tasks 
Which additional tasks should be performed? 
docker 


Select the additional tasks you would like Setup to perform while installing Boot2Docker 
for Windows, then dick Next. 


Add docker.exe/boot2docker.exe to PATH 
Reboot Windows at the end of installation 


Boot2Docker for Windows installation documentaticl is Becks) Len.) 


图 8-3” 义 选 “Reboot Windows at the end of installation 
(安装 完成 后 重启 电脑 ) 选项 


安 半 “通用 果 行 总 线 控制 普 ”， 如 图 8-4 所 示 。 


您 起 安装 这 个 设备 软件 吗 ? 


名 称 : Oracle Corporation 通用 言行 总 线 控 剂 器 
P d 23758: Oracle Corporation 


图 8-4 KRMH RITE SR" 


安装 完 CJE, 目 动 重启 电脑 。 局 动 Docker， 
选择 昔 面 图 标 Boot2Docker Start， 如 图 8-5 所 示 。 


图 8-5 ”桌面 图 标 Boot2Docker Start 


安装 成 功 验 证 ， 输 入 下 面 命令 验证 Docker 版 
本 ， 如 图 8-6 所 示 。 


docker -v 


* MINGW32:/c/Users/wisely 


export Di t CERT, PATH 
export DOCKER $ VERIFY 


IP address of docker UN: 
192.168.59.10) 


vetting environment variables 

writing C 5 " ^ c her-von^ „pon 

hoot2docher-un rt.pen 

$ t2doc ker un^*keu. pen 
DOCKER MH 

export DOCKER CERI. PATH= Jcers wise ly\\. boot2dockers\certs \\boot2docker 


export DOCKFR_TLS_UFRIFY «tf 


ean now use ‘docker directly, or ‘hoot2dochker ssh" to log into the UM. 


ome to Git Cversion 1.9.5 prevuieu280150119» 


“git help git’ to display the help inde 
‘git help <cammand>’ to display help for specific commands. 


, docker ~v 
Docker version 1.7 » build Ubaf bus 


Al8-6 ”验证 Docker 版 本 


此 时 VirtualBox 运 行 了 一 个 虚拟 机 。 打 开 
VirtualBox 软 件 ， 如 图 8-7 所 示 。 


Omen) d) ai deal c 


oxi ò ut 
mcHAmE5H DOM 
TT E 


Kl8-7  VirtualBox#x f 
8.1.2 Docker 党 用 命令 及 参数 


1.Docker 镜 像 命令 


基于 Docker 镜 像 征 可 以 目 己 编译 的 ， 我 们 将 
在 10.3 太 讲解 如 何 编译 目 己 的 Docker 锐 和 像 ， 本 万 
我 们 讲述 气 Docker 镜 像 控 作 相 天 的 命令 。 


通常 情况 下 ，Docker 的 镜像 都 放置 在 Docker 
官网 的 Docker Hub 上 ， 地 址 是 
https://registry.hub.docker.com， 如 图 8-8 所 示 。 


EZ redis ubuntu? Ww RDPRESS 


i à; [pum 
M y sat &* CentOS 
Fa ` " 
NGINX 
~ nede: 


图 8-8 Docker Hub 


(1) Docker 镜 像 检索 


除了 可 以 在 https://registry.hub.docker.com 网 站 
检索 镜像 以 外 ， 还 可 以 用 下 面 命 令 检 索 : 


docker search 镜像 名 


检索 Redis， 输 入 : 


docker search redis 


(2) 镜像 下 载 


下 载 镜像 通过 下 面 命令 实现 : 
docker pull 镜像 名 
下 载 Redis 锐 像 ， 运 行 : 
这 根据 据 网 络 情况 可 能 要 花费 一 段 时 间 。 
(3) 镜像 列表 
查看 本 地 镜像 列表 ， 如 图 8-9 所 示 ， 通 过 下 面 


iTS: 


=) 


docker images 


图 8-9 ”镜像 列表 


其 中 REPOSITORY 是 镜像 名 ; TAG 是 软件 版 
本 ，latest 为 最 新 版 ， IMAGE ID 是 当前 镜像 的 唯 


一 标识 ，CREATED 是 当前 镜像 创建 时 间 ; 
VIRTUAL SIZE 35 Bil Ei ER HJ] © 


(4) 镜像 删除 
删除 指定 镜像 通过 下 面 命令 : 
删除 所 有 镜像 通过 下 面 命令 : 


docker rmi $(docker images -q) 


2.DockerZx 28 fin 4 


(1) 容器 基本 操作 
最 创 单 的 运行 镜像 为 容 癸 的 命令 如 下 : 
docker run --name container-name -d image-name 


运行 一 个 容 姨 只 要 通过 Docker run 命 令 即 可 实 
现 ， 其 中 ，--name 参 数 是 为 容 絮 取得 名 称 ; -d 表 
示 detached， 意 味 着 执行 完 这 人 句 命 令 后 控制 台 将 不 
会 修 阻 碍 ， 可 继续 输入 命令 操作 ， 最 后 的 image- 
name 是 要 使 用 哪个 镜像 来 运行 容器 。 


人 四 MA 1 " my HH 
41 ]2E3511— T RedisZi zs: 
docker run --name test-redis -d redis 


DockerZ KRA JANA as E EE — PTR © 


通过 下 面 命令 ， 查 看 运行 中 的 容器 列表 ， 如 
图 8-10 所 示 。 


docker ps 


&lg-10 ale 


其 中 CONTAINER ID 是 在 启动 的 时 候 生 成 的 
ID; IMAGE Tike ae le FH JS; COMMAND 
XE UR SII US ARGS; CREATED Z8 GI f 
Ayla]; STATUSZé BIA aA AG; PORTSER 


器 系统 所 使 用 的 端口 号 ，Redis 默 认 使 用 6379 端 
口 ， NAMES 是 刚才 给 容器 定义 的 和 名称。 


通过 下 列 命令 可 查看 运行 和 停止 状态 的 容 


fi: 
Tem 
(3) 停止 和 启动 容器 
1) EIER ar 
停止 容器 通过 下 面 的 命令 : 


docker stop container-name/container-id 


我 们 可 以 通过 容器 名 称 或 者 容器 id 来 停止 容 
器 ， 以 停止 上 面 的 Redis 容 器 为 例 : 


docker stop test-redis 


此 时 运行 中 的 容器 列表 为 空 。 查 看 所 有 容器 
命令 ， 可 看 出 此 时 的 STATUS 为 退出 。 


2) Fae ae 
局 动容 天 通过 下 面 命 令 : 


docker start container-name/container -id 


FR BIBT A LE Ata 


docker start test-redis 


ERY A aie 1) FeO AB-11 TAN ° 


图 8-11 启动 刚才 停止 的 容器 
3) 端口 映射 


Docker 容 右 中 运行 的 软件 所 使 用 的 端口 ， 在 
本 机 和 本 机 的 局 域 网 是 不 能 访问 的 ， 所 以 我 们 需 
要 将 Docker 容 融 中 的 端口 映射 到 当前 主机 的 端口 
上 ， 这 样 我 们 在 本 机 和 本 机 所 在 的 局 域 网 承 能 够 
访问 该 软件 了 

Docker 的 站 口 映 射 是 通过 一 个 -p 参 数 来 实现 
HJ » Jf PARI RRedis7y fil, EITA 8886379! 
LISILEg63789m L1, MEU F: 


docker run -d -p 6378:6379 --name port-redis redis 


目前 在 Windows 下 运行 的 Docker 其 实 是 运行 
f£ VirtualBox ket. JL A ig ， 即 我 们 当前 的 本 机 并 不 
是 我 们 当前 的 开发 机 硕 if z VirtualBox TU. 
所 以 我 们 还 需要 再 做 一 Voti [1 PUR VirtualBox 
Ki SLA L1 BESTE 25 B JA AC Las o 300827 AZ 
THESE Pn ER EPA ETT © 


MERE Aa, ALTE Raa A 


docker rm container-id 


MRA Aa, FB RATS: 


P 


docker rm $(docker ps -a -q) 


my HE 


5) sm Hw 
得 看 当前 容 硕 日 志 ， 可 通过 下 面 的 命令 
docker logs container-name/container-id 


Bol EUR. BEI Peta H i, 如 图 8-12 
所 示 ， 命 令 如 下 : 


docker logs port-redis 


Éj MINGW32:/c/Users/wi 


using the default config. In order 


edis 3.8.2 〈DDDDDBBBAB》 64 bit 


ne mode 


H:M @6 Jul 13:26:18.412 # Server sta 
12 # WARNING 
12 # WARNING 


图 8-12 Aas E xS 


运行 中 的 容器 其 实 是 一 个 功能 完备 的 Linux 操 
作 系 统 ， 所 以 我 们 可 以 像 音 规 的 系统 一 样 登录 并 
Vilis ° 


我 们 可 以 使 用 下 面 命令 ， 登 录 访 问 当前 容 


aw, Aa RA n] DATE ERR Peet TR RU Linux AR 
iaa. 还 可 以 使 用 exit 命 令 退 出 登录 。 


docker exec -it container-id/container-name bash 


8.1.3 “下载 本 书 所 需 的 Docker 镜 像 


有 些 需 要 下 载 的 镜像 还 是 比较 大 的 ， 所 以 在 
此 处 先 下 载 下 来 ， 以 备 后 面 使 用 。 


Oracle xe、MongoDB、Redis、 和 
ActiveMQRabbit MQ 以 及 带 有 管理 界面 的 
RabbitMQ 的 镜像 分 别 如 下 : RabbitMQ 以 及 带 有 管 
理 界面 的 RabbitMQ: 


docker pull wnameless/oracle-xe-11g 
docker pull mongo 

docker pull redis:2.8.21 

docker pull cloudesire/activemq 
docker pull rabbitmq 

docker pull rabbitmq:3-management 


下 载 完 成 后 ， 查 看 Docker 镜 像 列表 ， 如 8-13 
所 示 。 


f5d621561b07 
8dT9c535f2eh4 
Ta92d3b5^4 

85b590597f95 


afrbOlfTlaf86 
O3d64ebc69 


图 8-13 ”Docker 镜 像 列表 


8.1.4 -有 异常 处 理 


各 出 现 命令 不 能 执行 的 销 误 ， 则 和 直接 使 用 下 
IB tit X5 VirtualBox E30 UT fa 4 : 


boot2docker ssh 


FER AN a, FRAT AS 


14 所 示 。 


@ MINGW32:/c/Users/wisely 


$ boot2docker ssh 
HH 
HH HH HH 
HH HH HH HH 


i 
| ， 
| 


LYXTEXTCO LT wf. 
和 天 Al 


Boot2Docker uersion 1.7.0, build master 
Docker version 1.7.0, build Obaf609 
docker@boot2docker:~$ docker images 


sunameless/oracle-xe-119 
webcenter/activemq 
docker@boot2docker: ~$ 


HH 


eal 


TAG 

2.8.21 
latest 
latest 
latest 
latest 


IMAGE ID 

8d79c535F2e4 
85b590597F95 
afbO1f7lafs6 
O803d64ebc69 
046ed760d1b1 


7960f90 - Thu Jun 18 18: 


31:45 UTC 2015 


CREATED 

2 days ago 
12 days ago 
12 days ago 
3 weeks ago 
6 months ago 


图 8-14 ”登录 虚拟 机 


8.2 Spring Data JPA 


8.2.1 所 有 睛 Spring Data JPA 


1. 什 么 是 Spring Data JPA 


在 介绍 Spring Data JPA 的 时 候 ， 我 们 首先 认识 
下 Hibernate。Hibernate 是 数据 访问 解决 反 术 的 绝对 
t, HORY} (Object-Relational Mapping) 
技术 实现 数据 访问 ，O/R 上 映射 即 将 领域 模型 类 和 数 
据 库 的 表 进 行 映 射 ， 通 过 程序 操作 对 象 而 实现 表 数 
I ， 让 效 据 访 问 操 作 无 须 天 注 效 据 库 相 


ba 4 HibermateH 247, Hibernate% Lr [EJB 3.0 
HYJPA#LYE , JPAR[Java Persistence API。JPA 是 一 个 
基于 OAR 映 射 的 标准 规范 《目前 最 新 版 本 是 JPA 
2.1) 。 所 谓 规 范 即 只 定义 标准 规则 (如 注解 、 接 
O) ， 不 提供 实现 ， 软 件 提供 商 可 以 按照 标准 规范 
来 实现 ， 而 使 用 者 只 需 按 照 规范 中 定义 的 方式 来 使 
用 ， 而 不 用 和 软件 提供 商 的 实现 打交道 。JPA 的 主 
要 实现 由 Hibernate、EclipseLink 和 OpenJPA 等 ， 这 


意味 着 我 们 只 要 使 用 JPA 来 开发 ， 无 论 是 哪 一 个 
开发 方式 都 是 一 样 的 。 


Spring Data JPA 是 Spring Data] — T FI H , 
它 通 过 提供 基于 JPA 的 Repository 极 大 地 减少 了 JPA 
作为 数据 访问 方案 的 代码 量 。 


2. 定 义 数据 访问 层 


使 用 Spring Data JPA 建 并 数据 访问 层 十 分 简 
单 ， 只 需 定义 一 个 继承 JpaRepository 的 接口 即 可 ， 
定义 如 下 : 
public interface PersonRepository extends 


JpaRepository«Person, Long» { 
// 定 义 数据 访问 操作 的 方法 


j 


继承 JpaRepository 接 口 意味 着 我 们 默认 已 经 有 
了 下 面 的 数据 访问 操作 方法 : 


QNoRepositoryBean 
public interface JpaRepository<T, ID extends Serializable> 
extends PagingAndSortingRepository<T, ID» { 
List<T> findAll(); 
List<T> findAll(Sort sort); 
List<T> findAll(Iterable<ID> ids); 
<S extends T> List<S> save(Iterable<S> entities); 
void flush(); 
<S extends T> S saveAndFlush(S entity); 
void deleteInBatch(Iterable<T> entities); 
void deleteAllInBatch(); 
T getOne(ID id); 


3. 配 置 使 用 Spring Data JPA 


在 Spring 环境 中 ， 使 用 Spring Data JPA 可 通过 
@EnableJpaRepositories 注 解 来 开局 Spring Data JPA 
的 文 持 ，@EnableJpaRepositories 接 收 的 value 参 数 用 
来 扫 手 数据 访问 层 所 在 包 下 的 数据 访问 的 接口 十 
bd o 


QConfiguration 
QEnableJpaRepositories("com.wisely.repos") 
public class JpaConfiguration { 
QBean 
public EntityManagerFactory entityManagerFactory() { 
La 


} 
// 还 需 配 置 DataSource、PlatformTransactionManager 等 相关 必须 
bean 


} 


4. 定 义 碍 询 方法 


在 讲解 查询 方法 前 ， 假 设 我 们 有 一 张 数据 表 叫 
PERSON， 有 ID (Number) ^ NAME 
(Varchar2 ` AGE (Number) ` ADDRESS 
(Varchar2) 几 个 字段 ; 对 应 的 实体 类 叫 Person， 分 
别 有 id (Long) ^name (String) "age 
(Integer) ^ address (String) 。 下 面 我 们 束 以 这 个 
fey ERASE (AEE VE AYER © 


(1) 根据 属性 名 查询 


Spring Data JPA 文 持 通 过 定义 在 Repository 接 口 
中 的 方法 名 来 定义 查询， 而 方法 名 是 根据 实体 类 的 
属性 名 来 确定 的 。 


1) 常规 查询 。 根 据 属 性 名 来 定义 查询 方法 ， 
示例 如 下 : 


public interface PersonRepository extends 
JpaRepository«Person, Long» { 
JER 
* 
* 通过 名 字 相 等 查询 ， 参 数 为 name 
* 相当 于 JPQL:select p from Person p where p.name=?1 


List<Person> findByName(String name); 
JER 


* 通过 名 字 1ike 查 询 ， 参 数 为 name 
当 于 JPQL: select p from Person p where p.name like ?1 


List<Person> findByNameLike(String name); 
JU 


* 通过 名 字 和 地 址 查询 ,参数 为 name 和 address 

* 相当 于 JPQL: select p from Person p where p.name=?1 and 
p.address-?2 

*/ 

List<Person> findByNameAndAddress(String name, String 
address); 


} 


从 代码 可 以 看 出 ， 这 里 使 用 了 findBy、Like、 
And 这 样 的 天 键 字 。 其 中 findBy 可 以 用 find ` read ` 
readBy ` query ^ queryBy ^ get ^ getBy2E fV E ° 


而 Like 和 and 这 类 查询 天 键 字 ， 如 表 8-2 所 示 : 


表 8-2 


查询 关键 子 


关键 字 m fil 同 功能 JPQL 
And fndByLastnameAndFirstname where x.lastname = ?1 and x.firstname = 22 
Or findByLastnameOrFirstname where x.lastname = ?1 or x.firstname = ?2 
Is.Equals findByFirstname.findByFirstnamels,findBy where x.firstname = 1? 

FirstnameEquals 

Between findByStartDateBetween where x.startDate between 1? and ?2 
LessThan findByA geLessThan where x.age < ?1 
LessThanEqual findByAgeLessThanEqual where x.age = ?1 
GreaterThan findByAgeGreaterThan where x.age > ?1 
GreaterThanEqual findByAgeGreaterThanEqual where x.age >= ?1 
After findB yStartDateA fter where x.startDate > ?1 
Before findByStartDateBefore where x.startDate < ?1 
IsNull findByAgelsNull where x.age is null 
IsNotNull,NotNull findByAge(Is)NotNull where x.age not null 
Like findByFirstnameLike where x.firstname like ?1 
NotLike findByFirstnameNotLike where x.firstname not like ?1 
StartingWith findByFirstnameStartingWith where x.firstname like ?1 (参数 前 面 加 %) 
EndingWith findByFirstnameEndingWith where x.firstname like ?1 (参数 后 面 加 %) 
Containing findByFirstnameContaining where x.firstname like ?1 (参数 两 边 加 %) 
OrderBy findByA geOrderB yLastnameDesc where x.age = ?1 order by x.lastname desc 
Not findByLastnameNot where x.lastname «» ?1 
In findByAgelIn(CollectioncAge» ages) where x.age in ?1 
NotIn findByA geNotIn(CollectioncAge» age) where x.age not in ?1 
True findByActiveTrue() where x.active = true 
False findB yActiveFalse() where x.active = false 
IgnoreCase findByFirstnamelgnoreCase where UPPER(x.firstame) = UPPER(?1) 


2) 限制 结果 数量 


字 来 实现 的 ， 


例如 : 


结果 数量 是 用 top 和 first 天 键 


public interface PersonRepository extends 


JpaRepository<Person, Long> { 
/* * 
* 
* 获得 符合 查询 条 件 的 前 10 条 数据 


AY: 


List«Person» findFirsti0ByName(String 


n> 
"d 


名 条 件 的 前 30 条 数据 


name); 


* 
*/ 
List<Person> findTop30ByName(String name); 


(2) 使 用 JPA 的 NamedQuery 查 询 


Spring Data JPA 文 持 用 JPA 的 NameQuery 来 定义 
得 询 方法 ， 即 一 个 名 称 映射 一 个 查询 语句 。 和 定义 如 
P: 


QEntity 
@NamedQuery(name = "Person.findByName", 

query = "select p from Person p where p.name=?1") 
public class Person { 


} 


使 用 如 下 语句 : 


public interface PersonRepository extends 
JpaRepository«Person, Long» { 


[tt 

* 这 时 我 们 使 用 的 是 NamedQuery 里 定义 的 查询 语句 ， 而 不 是 根据 方法 名 称 查 
询 

*/ 

List<Person> findByName(String name); 
} 


(3) 使 用 @Query 查 询 


1) 使 用 参数 索引 。Spring Data JPA 还 支持 用 
@Query 注 解 在 接口 的 方法 上 实现 得 询 ， 例 如 : 


public interface PersonRepository extends 
JpaRepository«Person, Long» { 
QQuery("select p from Person p where p.address-?1") 
List«Person» findByAddress(String address); 


2) 使 用 命名 参数 。 上 面 的 例子 是 使 用 参数 的 
索引 号 来 查询 的 ， 在 Spring Data JPA 里 还 文 持 在 语 
句 里 用 名 称 来 匹配 查询 参数 ， 例 如 : 


public interface PersonRepository extends 
JpaRepository«Person, Long» { 


QQuery("select p from Person p where p.address- :address") 


List«Person» findByAddress(QParam("address") String 
address); 


3) 更 新 查询 。Spring Data JPA X: f$ Modifying 
和 人 @Query 注 解 组 合 来 事件 更 新 查询 ， 例 如 : 


public interface PersonRepository extends 
JpaRepository«Person, Long» ( 


QModifying 

QTransactional 
@Query("update Person p set p.name-?1") 
int setName(String name); 


j 


其 中 返回 值 int 表 示 更 新 语句 影响 的 行 数 。 


(4) Specification 


JPA 提 供 了 基于 准则 查询 的 方式 ， 即 Criteria 查 
E 而 Spring Data JPA 提 供 了 一 个 Specification (ll 
18) 接口 让 我 们 可 以 更 方便 地 构造 准则 查询 , 
qux 口 定 义 了 一 个 toPredicate 方 法 用 来 构 
造 查询 条 件 。 


1) 定义 。 我 们 的 接口 类 必需 实 
JpaSpecificationExecutor## O , ken 


public interface PersonRepository extends 
JpaRepository<Person, Long>, 
JpaSpecificationExecutor<Person> { 


} 


然后 需要 定义 Criterial 查 询 ， 代 码 如 下 : 


import javax.persistence.criteria.CriteriaBuilder; 

import javax.persistence.criteria.CriteriaQuery; 

import javax.persistence.criteria.Predicate; 

import javax.persistence.criteria.Root; 

import org.springframework.data.jpa.domain.Specification; 
import com.wisely.domain.Person; 


public class CustomerSpecs { 


public static Specification<Person> personFromHefei() { 
return new Specification<Person>() { 


@Override 
public Predicate toPredicate(Root<Person> root, 


CriteriaQuery<?> query, CriteriaBuilder cb) { 


return cb.equal(root.get("address"), "@fH"); 


我 们 使 用 Root 来 获得 需要 查询 的 属性 ， 通 过 
CriteriaBuilder 构 造 查 询 条 件 ， 本 例 的 含义 是 出 所 
有 来 目 合肥 的 人 。 


注意 : CriteriaBuilder ^ CriteriaQuery ^ 
Predicate ^ Rootß X A JPARS O ° 


CriteriaBuilder 包 含 的 条 件 构 造 有 : exists ^ 
and ^ or ^ not ^ conjunction ^ disjunction ^ isTrue ^ 
isFalse ` isNull ` isNotNull ` equal ` notEqual ^ 
greaterThan ^ greaterThanOrEqualTo ^ lessThan ^ 
lessThanOrEqualTo ` between, YÉZIi 2G 
CriteriaBuilderB'JAPI ° 


2) 使 用 * EEG 


import static com.wisely.specs.CustomerSpecs.*; 


IN personRepositoryHBean/r : 


List<Person> people = 
personRepository.findAll(personFromHefei()); 


(5) 排序 与 分 页 


Spring Data JPA 友 分 考虑 了 在 实际 开发 中 所 必 
需 的 排序 和 分 页 的 场景 ， 为 我 们 提供 了 Sort 类 以 及 
Paget #llPageabled# O ° 


Pz \) 
1) 定义 : 
package com.wisely.repos; 


import java.util.List; 


import org.springframework.data.domain.Page; 

import org.springframework.data.domain.Pageable; 

import org.springframework.data.domain.Sort; 

import org.springframework.data.jpa.repository.JpaRepository; 
import org.springframework.data.jpa.repository.Modifying; 
import org.springframework.data.jpa.repository.Query; 

import org.springframework.data.repository.query.Param; 


import com.wisely.domain.Person; 
public interface PersonRepository extends 
JpaRepository«Person, Long» ( 


List«Person» findByName(String name,Sort sort); 
Page<Person> findByName(String name,Pageable pageable); 


2) 使 用 排序 : 


List<Person> people = personRepository.findByName("xx", new 
Sort(Direction.ASC, age")); 


3) 使 用 分 页 : 


Page<Person> people2 = personRepository.findByName("xx", new 
PageRequest(0, 10)); 


其 中 Page 接 口 可 以 获得 当前 页 面 的 记录 、 总 页 
> MOR > EGA LMR OAS o 


5. 目 定义 Repository 的 实现 


Spring Data 提 供 了 和 CrudRepository ^ 
PagingAndSortingRepository; Spring Data JPA 也 提 
供 了 JpaRepository。 如 果 我 们 想 把 目 己 第 用 的 数据 
库 操 作 封 装 起 来 ， 像 了 paRepository 一 样 捉 供给 我 们 
领域 类 的 Repository 接 口 使 用 ， 应 该 怎么 探 做 呢 ? 


(1) 定义 目 定义 Repository 接 口 : 


QNoRepositoryBean//1 
public interface CustomRepository<T, ID extends 
Serializable>extends PagingAndSortingRepository<T, ID» {//2 


public void doSomething(ID id);//3 


代码 解释 


@@NoRepositoryBean 指 明 当 前 这 个 接口 不 是 
我 们 领域 类 的 接口 (如 PersonRepository ° 


我 们 目 定 义 的 Repository 实 现 
PagingAndSortingRepository 接 口 ， 有 具备 分 页 和 排序 


@ 要 定义 的 数据 操作 方法 在 接口 中 的 定义 。 
(2) 定义 接口 实现 : 


public class CustomRepositoryImpl «T, ID extends Serializable» 
extends SimpleJpaRepository<T, ID» 
implements CustomRepository<T,ID> {//1 


private final EntityManager entityManager ;//2 
public CustomRepositoryImpl(Class«T» domainClass, 
EntityManager entityManager) {//3 
super(domainClass, entityManager); 
this.entityManager - entityManager; 
j 
@Override 


public void doSomething(ID id) { 
// 4 


j 


代码 解释 

首先 要 实现 CustomRepository 接 口 ， 继 承 
SimpleJpaRepository 类 让 我 们 可 以 使 用 其 提供 的 方 
法 (如 findAll) 。 


让 数据 操作 方法 中 可 以 使 用 entityManager。 


G CustomRepositoryImplÉ] $538 Bal, Fe 4 BA 
理 的 领域 类 类 型 和 entityManager 作 为 构造 参数 ， 在 
这 里 也 给 我 们 的 entityManager 赋 值 了 ° 


在 此 处 定义 数据 访问 操作 ， 如 调用 findAll 方 


法 并 构造 一 些 查 询 条 件 。 


(3) 目 定 义 RepositoryFactoryBean。 目 定义 
JpaRepositoryFactoryBean EET RERI 
RepositoryFactoryBean， 我 们 会 获得 一 个 
RepositoryFactory，RepositoryFactory 将 会 注册 我 们 
目 定义 的 Repository 的 实现 : 


public class CustomRepositoryFactoryBean<T extends 
JpaRepository<S, ID», S, ID extends Serializable> 
extends JpaRepositoryFactoryBean<T, S, ID» {// 1 


@Override 
protected RepositoryFactorySupport 
createRepositoryFactory(EntityManager entityManager) {// 2 
return new CustomRepositoryFactory(entityManager ) ; 


} 


private static class CustomRepositoryFactory extends 
JpaRepositoryFactory {// 3 


public CustomRepositoryFactory(EntityManager 
entityManager) { 
super (entityManager ); 


} 


@Override 
@SuppressWarnings({"unchecked"} ) 
protected <T, ID extends Serializable> 
SimpleJpaRepository«?, ?> getTargetRepository( 
RepositoryInformation information, 


EntityManager entityManager) {// 4 
return new CustomRepositoryImpl<T, ID>((Class<T>) 
information.getDomainType(), entityManager ); 


} 
@Override 
protected Class<?> 
getRepositoryBaseClass(RepositoryMetadata metadata) {// 5 
return CustomRepositoryImpl.class; 
} 


} 
} 


TORO HENE 


(DB xe “<RepositoryFactoryBean, 47K 
JpaRepositoryFactoryBean ° 


(2) 重 写 createRepositoryFactory 方 法 ， 用 当前 的 
CustomRepositoryFactory 创 建 实 例 。 


G) 创 建 CustomRepositoryFactory， 并 继承 
JpaRepositoryFactory ? 


(9) 重 写 getTargetRepository 方 法 ， 获 得 当前 目 定 
义 的 Repository 实 现 。 


9) 重 写 getRepositoryBaseClass， 获 得 当前 目 定 
义 的 Repository 实 现 的 类 型 。 


(4) 开局 目 定义 文 持 使 用 
@EnableJpaRepositoriesHJrepositoryFactoryBeanClass 


来 指定 FactoryBean 即 可 ， 代 码 如 下 : 


QEnableJpaRepositories(repositoryFactoryBeanClass- 
CustomRepositoryFactoryBean.class) 


0.2.2 Spring Bootb 的 文 持 


1.JDBC 的 自动 配置 


spring-boot-starter-data-jpa 依 顿 于 Spring-boot- 
starter-jdbc， 而 Spring Boot 对 JDBC 做 了 一 些 目 动 配 
置 。 源 码 放置 在 
org.springframework.boot.autoconfigure.jdbc 下， 如 
8-15 所 示 。 


4 [88 jdbc 
n 出 metadata 
te DatabaseDriver.class 
15 DataSourceAutoConfiguration.class 
DataSourceBuilder.class 
$ù DataSourceConfigMetadata.class 
» $ DataSourcelnitializedEvent.class 
$ù DataSourcelnitializer.class 
hy DataSourcelnitializerPostProcessor.class 
$a DataSourceProperties.class 


1$ DataSourceTransactionManagerAutoConfiguration.class 


to DriverClassNameProvider.class 
15$ EmbeddedDatabaseConnection.class 

> T EmbeddedDataSourceConfiguration.class 
JndiDataSourceAutoConfiguration.class 
1» XADataSourceAutoConfiguration.class 


图 8-15” ”JDBC 源码 位 置 


从 源码 分 析 可 以 看 出 ， 我 们 通 
过 “spring.datasoure” 为 前 弧 的 属性 目 动 配置 
dataSource; Spring Boot 目 动 开 局 了 注解 事务 的 支持 
(@EnableTransactionManagement) ; 还 配置 了 一 
个 jdbcTemplate。 


Spring Boot 还 提供 了 一 个 初始 化 数据 的 功能 : 
放置 在 类 路 径 下 的 schema.sql 文 件 会 自动 用 来 初始 
化 表 结 构 ， 放 置 在 类 路 人 径 下 的 data.sql 文 件 会 日 动用 
来 填充 表 数 据 。 


2. 对 JPA 的 目 动 配置 


Spring Boot 对 JPA 的 目 动 配置 放置 在 


org.springframework.boot.autoconfigure.orm.jpa P , 


如 图 8-16 所 示 。 


4 出 ormjpa 
hy DataSourcelnitializedPublisher.class 
fia Entity ManagerFactoryBuilder.class 


$a HibernateJpaAutoConfiguration.class 
lis JpaBaseConfiguration.class 
tá JpaProperties.class 


图 8-16 JPA 的 源码 位 置 


从 HibernateJpaAutoConfiguration 可 以 看 出 ， 
Spring Boot 默 认 JPA 的 实现 者 是 Hibernate; 
HibernateJpaAutoConfiguration 依 顿 于 
DataSourceAutoConfiguration ° 


从 JpaProperties 的 源码 可 以 看 出 ， 配 置 JPA 可 以 
使 用 spring.j pa 为 前 级 的 属性 在 application.properties 
中 配置 。 


从 JpaBaseConfiguration 的 源码 中 可 以 看 出 ， 
Spring Boot 为 我 们 配置 了 transactionManager、 
jpaVendorAdapter、entityManagerFactory 等 Bean。 
JpaBaseConfigurationi4H — T getPackagesToScan7;7 
法 ， 可 以 自动 扫描 注解 有 @Entity 的 实体 类 。 


在 Web 项 目 中 我 们 经 第 会 遇 到 在 控制 右 或 者 页 
面 访问 数据 的 时 候 出 现 会 话 连 授 已 天 闭 的 错误 ， 这 
时 候 我 们 会 配置 一 个 Open EntityManager 

(Session) In View 这 个 过 滤 右 。 令 人 惊喜 的 是 ， 
Spring Boot 为 我 们 目 动 配置 了 
OpenEntityManagerInViewInterceptor 这 个 Bean， 并 


注册 到 Spring MVC 的 拦截 絮 中 。 
3. 对 Spring Data JPA 的 自动 配置 


而 Spring Boot 对 Spring Data JPA 的 目 动 配置 放 
置 在 org.springframework.boot.autoconfigure.data.jpa 


下 ， 如 图 8-17 所 示 。 


4 {§ data 
H3 elasticsearch 
4 出 jpa 
EntityManagerFactoryDependsOnPostProcessor.class 


全 JpaRepositoriesAutoConfiguration.class 


1 JpaRepositoriesAutoConfigureRegistrar.class 


图 8-17 Spring Data JPA 的 自动 配置 


从 JpaRepositoriesAutoConfiguration 和 
JpaRepositoriesAutoConfigureRegistrari/Àfi n] DJ E 
出 ，JpaRepositoriesAutoConfiguration 是 依 顿 于 
HibernateJpaAutoConfiguration 配 置 的 ， 且 Spring 


Boot 目 动 开局 了 对 Spring Data JPA 的 文 持 ， 即 我 们 
无 须 在 配置 类 显示 声明 @EnableJpaRepositories 。 


4.Spring Boot 下 的 Spring Data JPA 


通过 上 面 的 分 析 可 知 ， 我 们 在 Spring Boot 下 使 
用 Spring Data JPA， 在 项 目的 Maven 依 赖 里 添加 
spring-boot-stater-data-jpa， 然 后 只 需 定义 
DataSource、 实 体 类 和 数据 访问 层 ， 并 在 需要 使 用 
数据 访问 的 地 方 注 入 数据 访问 层 的 Bean 即 可 ， 无 须 
任何 额外 配置 。 


8.2.3 ”实战 


在 本 三 的 实战 里 ， 我 们 将 演示 基于 方法 名 的 但 
询 、 基 于 @Query 的 查询 、 分 页 及 排序 ， 最 后 我 们 
将 结合 Specification 和 目 定 义 Repository 实 现 来 完成 
一 个 通用 实体 奋 询 ， 即 对 于 任 芒 类 型 的 实体 类 的 传 
值 对 象 ， 只 要 对 象 有 值 的 属性 我 们 就 进行 目 动 构造 
查询 (字符 型 用 like， 其 他 类 型 用 等 于 ) 。 这 里 起 
一 个 抛砖引玉 的 功能 ， 感 兴趣 的 读者 可 以 继续 扩 
展 ， 如 构造 范围 但 询 及 天 联 表 查询 等 。 


1. 安 装 Oracle XE 


因 天 部 分 Java 程 序 员 在 实际 开发 中 一 般 使 用 的 
是 Oracle， 所 以 此 处 选择 用 Oracle XE 作为 开发 测试 
数据 库 。 


Oracle XE 是 Oracle 公 司 提供 的 免费 开发 测试 用 
途 的 数据 库 ， 可 目 由 使 用 ， 功 能 和 使 用 与 Oracle 完 
全 一 致 ， 但 数据 大 小 限制 为 4G。 


(1) 非 Docker 安 装 


Ad T8 8 FA DockerZcOracle XE 的 读者 请 至 
http://www.oracle.com/technetwork/database/database- 
technologies/express-edition/downloads/index.html 下 
载 Oracle XE 安装 。 


(2) Docker 安 装 


我 们 在 8.13 记 已 经 下 载 了 Oracle XE 的 镜像 ， 现 
在 我 们 运行 局 动 一 个 Oracle XERRA ° 


docker run -d -p 9090:8080 -p 1521:1521 wnameless/oracle-xe- 
11g 


将 容器 中 的 Oracle XE HA A A 8080»m O BY 
AIAN LA 090m L1, Oracle XEBJ1521»g ART A 
本 机 的 1521 端 口 。 


ANS a he BERI PHAR I 


hostname: localhost 
端口 :1521 

SID: XE 
username:system/sys 
password:oracle 


SAV [HI 


url:http://localhost :9090/apex 
workspace: internal 

username: admin 

password:oracle 


(3) 端口 映射 


Je WES. P HERPES, AeA in AR 
5j £l VirtualBox AALE, a P LER IRAE 
需要 我 们 把 VirtualBox 的 虚拟 机 的 端口 映射 到 当前 
FENU E ° IALA AMA, BEEE AAR 
们 一 般 都 是 基于 Linux 部 署 Docker 的 ， 所 以 不 会 存在 
这 个 问题 。 


下 面 我 们 演示 将 VirtualBox 虚 拟 机 的 端口 映射 
BI) HTT ACH Lae 


打开 VirtualBox 软 件 ， 如 图 8-18 所 示 。 


8% Oracle VM VirtualBox 管理 器 
EEF FAM) RH) 


Gay] 加 备份 [系统 快照] G) 


JM HG) Z700 BAe 


boot2docker-vm 


名 称 : 
操作 系统 : Linux 2.6 / 3.x (64 bit) 
系统 

大 小 : 2048 Mb 


处 理 器 : s 
启动 顺序 : 光驱 ， 光 驱 ， 硬 盘 
硬件 加 束 : VI-x/AMD-V, ET, PAR/NX 


E 显示 

显存 大 小 8 MB 
远程 点 面 服务 器 :已 禁用 
FR Bag 
TM 

控制 器 : SATA 


SATA WC] 0: [光驱 ] boot2docker.iso (26.00 MB) 
SATA #20] 1: boot2docker-vm.vmdk (普通 ，19. 53 GB) 


p 声音 
已 禁用 
WP 网 络 


图 8-18 ”打开 VirtualBox 软 件 


寺中 boot2docker-vm， 单 击 “ 设 置 ?按钮 ， 或 者 
右 击 ， 在 右键 采 早 中 选中 “设置 "打开 虚 拟 机 设置 
页 面 ， 如 图 8-19 所 示 。 


基本 (8) 
名 称 QD: [boot2docker-vm E 


类 型 (T): (Linux 


ME): [Linux 2.6 / 3.x (4 bit) 


发 现 无 效 设置 


Als-19 ”打开 虚拟 机 设置 页 面 


单 击 “ 网 络 ”"”， 页 面 下 方 出 现 了 “ 曾 口 转发 ” 按 
钮 ， 如 图 8-20 所 示 。 


[7] BRR Œ) 
连接 方式 外 ): 
SEN: [ 
v BRW 


控制 芯片 0): [ 淮 虚拟 化 网 络 (irtio-net) 
混杂 模式 ©): [拒绝 


MAC 地址 qb: |080027FB23F2 
T BARE © 


Car J| ma ] | amo | 


图 8-20 “端口 转发 ”按钮 


单 击 “ 疹 品 转发 ”按钮 ， 弹 出 “端口 转发 规则 ? 界 
面 ， 将 我 们 刚才 上 曝露 到 虚拟 机 的 9090 及 1521 喘 口 映 
射 为 开发 机 的 9090 及 1521 端 口 ， 如 图 8-21 所 示 。 


EP 请 口 转发 规则 - 9 
| 名 称 协议 主机 ip sR FRAP 子 系 统 端口 | D> 
| ssh TCP 127.0.0.1 2022 22 e 
loracle xe web ui TCP 127.0.0.1 9090 9090 
| oracle xe TCP 127.0.0.1 1521 
交 表 格 包 会 了 端口 转发 规则 
取消 | 


图 8-21 将 虚拟 机 端口 映射 为 开发 机 端口 


做 了 如 上 设置 后 ， 我 们 即 可 通过 本 机 9090 及 
1521 端 口 正 确 访问 Oracle XE 容器 里 的 端口 ° 


(4) 管理 


BW LMR Ze, Kii EL RPRIEIDIB 
的 Oracle 数 据 库 一 样 哥 作 Oracle XE 了 。 我 们 可 以 通 
过 访问 XE 的 管理 界面 : http://localhost: 9090/apex 
登录 管理 数据 库 ; KAENA HLS Oracle 
Client， 管 理 并 安装 一 个 数据 库 管 理工 具 (如 
PL/SQL Developer) 来 管理 数据 库 。 


利用 我 们 的 管理 工具 (如 PL/SQL Developer) 
创建 一 个 用 户 ， 作 为 我 们 程序 使 用 的 数据 库 账号 ， 
账号 密码 宵 为 boot 。 


3.81 Spring Boot 项 目 


搭建 Spring Boot 项 目 ， 依 赖 选 择 JPA (spring- 
boot-starter-data-jpa) 和 Web (spring-boot-starter- 
web) 。 


Jo E fei s: 


groupId: com.wisely 
arctifactId:ch8 2 
package: com.wisely.ch8 2 


因为 我 们 使 用 的 是 Oracle XE 数 据 库 ， 所 以 需要 
使 用 Oracle 的 JDBC 张 动 ， 而 Maven 中 心 库 没 有 
Oracle JDBC 的 驱动 下 载 ， 因 此 我 们 需要 通过 Maven 
命令 ， 目 己 打 包 Oracle 的 JDBC 弛 动 到 本 地 库 。 


在 Oracle 家 网 下 载 ojdbc6.jar 
(http://www.oracle.com/technetwork/database/enterpr 
ise-edition/jdbc-112010-090769.html) ， 当 然 一 般 我 
们 都 有 这 个 jar 包 。 


通过 在 控制 合 执行 下 面 命 令 ， 将 ojdbc6.jar 安 凑 
到 本 地 库 : 


mvn install:install-file -DgroupId=com.oracle "- 
DartifactId=ojdbc6" "-Dversion=11.2.0.2.0" "-Dpackaging-jar" 
"-Dfile=E:\ojdbc6. jar" 
Wh HH: 
-Dgroupld=com.oracle: 指定 当前 包 的 groupId 为 
com.oracle ° 
-DartifactId=ojdbc6: 指定 当前 包 的 artifactfactId 
为 ojdbc6 。 
-Dversion-11.2.0.2.0: 指定 当前 包 version 为 
11.2.0.2.0。 
-Dfile=E: \ojdbc6.jar: 指定 要 打包 的 jar 的 文件 
位 置 。 


此 时 ojdbc6 被 打包 到 本 地 库 ， 如 图 8-22 所 示 。 


新 加 卷 (C:) » FR > wisely » .m2 » repository » com » oracle » ojdbc6 » 11.2.0.2.0 
HEY 新 建文 件 夫 


名 称 TAR 类 型 大 小 
AME mote.repositories 2015/7 

(4| ojdbc6-11.2.0.2.0 

|_| ojdbc6-11.2.0.2.0.pom 


DOM vm 
PON | 


图 8-22 ojdbc6 被 打包 到 本 地 库 


这 时 我 们 只 需 在 Spring Boot 项 目 中 的 pom.xml 
加 入 下 面 坐标 即 可 引入 ojdbc6: 


«dependency» 
«groupId»com.oracle«c/groupId-» 
«artifactiId»0ojdbce«c/artifactid» 
<version>11.2.0.2.0</version> 

</dependency> 


添加 google guava 依 赖 ， 它 包含 大 量 Java 和 常用 的 
TER: 


<dependency> 
<groupiId>com. google. guava</groupId> 
<artifactId>guava</artifactId> 
<version>18.0</version> 
</dependency> 


S E — 1 data.sql MFI TE src/main/resources 
下 ， 内 容 为 同 表格 增加 一 些 数 据 ， 数 据 插入 完成 后 
请 删除 或 对 此 文件 改名 : 


insert into person(id,name,age,address) 
values(hibernate sequence.nextval, ' 江 云 飞 ', 32, ' 合 肥 ' )， 
insert into person(id,name,age,address) 
values(hibernate sequence.nextval, 'xx',31, ' 北 京 ' ); 
insert into person(id,name,age,address) 
values(hibernate sequence.nextval, 'yy 


' ,30, ' 上 海 ' );， 
insert into person(id,name,age,address) 
values(hibernate_sequence.nextval, 'zz 


' ,29,' 南 京 ' ) ; 
insert into person(id,name,age,address) 
values(hibernate sequence.nextval,'aa 


/,28, BAL"); 
insert into person(id,name,age,address) 
values(hibernate sequence.nextval, 'bb 


' 7 27，' 合 肥 ' ); 
4. 配 置 基本 属性 


在 application.properties 里 配置 数据 源 和 jpa 有 的 相 

y 
天 属性 。 

spring.datasource.driverClassName-oracle.jdbc.OracleDriver 

spring.datasource.url-jdbc 

N:oracleN:thinN:Qlocalhost 

\:1521\:xe 

spring.datasource.username=boot 

spring.datasource.password-boot 

#1 

spring. jpa.hibernate.ddl-auto=update 

#2 

spring. jpa.show-sql=true 

#3 


spring. jackson.serialization. indent_output=true 
代码 解释 


上 面 代 码 第 一 段 是 用 来 配置 数据 产 ， 第 二 段 是 
用 来 配置 jpa， 更 多 配置 内 容 请 查看 附录 A.3 
以 “spring.datasource” 和 “spring.jpa” 为 前 组 的 属性 配 


O 〇 


@hibernate 提 供 了 根据 实体 类 日 动 维护 数据 库 
表 结 构 的 功能 ， 可 通过 spring.jpa.hibernate.ddl-auto 
来 配置 ， 有 下 列 可 选项 : 


e create: 局 动 时 删除 上 一 次 生成 的 表 ， 并 根据 实 
体 类 生成 表 ， 表 中 数据 会 个 清 空 。 

e create-drop: 局 动 时 根据 实体 类 生成 表 ， 
sessionFactory X HRT RSIR ° 

« update: 局 动 时 会 根据 实体 类 生成 表 ， 当 实体 类 
属性 变动 的 时 候 ， 表 结构 也 会 更 新 ， 在 初期 开 
发 阶段 使 用 此 选项 。 

e validate: 局 动 时 验证 实体 类 和 数据 表 是 人 否 一 
致 ， 在 我 们 数据 结构 稳定 时 采用 此 选项 。 

enone: 不 采取 任何 措施 。 


@spring.j jpa. show-sql H ix Ehibernatet&f EH 
时 候 在 控制 台 显 示 其 真实 的 Sql 语句 。 


G 让 控制 器 输出 的 json 字 符 串 格式 更 美观 。 
5. 定 义 有 映射 实体 类 
Hibernate 文 择 目 动 将 实体 闫 映射 为 数据 表格 : 
package com.wisely.domain; 
import javax.persistence.Entity; 


import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity //1 
@NamedQuery(name = "Person.withNameAndAddressNamedQuery", 
query = "select p from Person p where p.name=?1 and address=? 
2") 
public class Person { 

QId //2 

@GeneratedValue //3 

private Long id; 


private String name; 
private Integer age; 
private String address; 


public Person() ( 
super(); 


public Person(Long id, String name, Integer age, String 
address) ( 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 
this.address - address; 


j 


// 省 略 setter、getter 


代码 解释 


@@Entity 注 解 指明 这 是 一 个 和 数据 库 表 映 射 的 
实体 类 。 


" @ (Idi ETREAISUT ES PERRET Bs YE 
E o 


G(g Generated Valul} E EA V fi H EE p, 73 3X 
为 和 目 增 ，hibernate 会 为 我 们 目 动 生 成 一 个 名 为 
HIBERNATE SEQUENCE 的 序列 。 


在 此 例 中 使 用 的 注解 也 许 和 你 平时 经 常 使 用 的 
注解 实体 类 不 大 一 样 ， 比 如 没有 使 用 @Table [d 
类 映射 表 名 ) ` @Column (属性 映射 字段 名 ) 注 
解 。 这 是 因为 我 们 是 采用 让 向 工程 通过 实体 类 生成 
i 而 不 是 通过 逆向 工程 从 表 结 构 生 成 数据 
车 o 


在 这 里 你 可 能 注意 到 ， 我 们 没有 通过 @Column 
注解 来 注解 普通 属性 ，@Column 是 用 来 映 遇 属性 名 
和 字段 名 ， 不 注解 的 时 候 hibernate 会 自动 根据 属性 
Z ERARA ° WR IEZ nameta EE 
NAME; 多 字母 属性 如 testName 会 目 动 映 射 为 
TEST_NAME。 表 名 的 映射 规则 也 如 此 。 


6. 定 义 数据 访问 接口 
package com.wisely.dao; 


import java.util.List; 


import org.springframework.data.jpa.repository.JpaRepository; 
import org.springframework.data.jpa.repository.Query; 


import com.wisely.domain.Person; 


public interface PersonRepository extends 
JpaRepository«Person, Long» ( 

//1 

List«Person» findByAddress(String name); 


//2 

Person findByNameAndAddress(String name,String address); 

//3 

QQuery("select p from Person p where p.name- :name and 
p.address- :address") 

Person withNameAndAddressQuery(QParam("name")String name, 
QParam("address")String address); 

//4 


List«Person» withNameAndAddressNamedQuery(String 
name,String address); 


j 
代码 解释 


(使 用 方法 名 查询 ， 接 受 一 个 name 参 数 ， 返 回 
值 为 列表 。 


(2) 使 用 方法 名 查询 ， 接 受 name 和 address， 返 回 
值 为 单个 对 象 。 


(9) 使 用 @Query 查 询 ， 参 数 按照 名 称 绑 定 。 


(4) 使 用 @NamedQuery 查 询 ， 请 注意 我 们 在 实体 
关中 做 的 @NamedQuery 的 定义 。 
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ERARA BRA ee, BOE 
PersonRepository 注 入 到 控制 锅 中 ， 以 简化 演示 。 


package com.wisely.web; 


import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.data.domain.Page; 

import org.springframework.data.domain.PageRequest; 

import org.springframework.data.domain.Sort; 

import org.springframework.data.domain.Sort.Direction; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 


import com.wisely.dao.PersonRepository; 
import com.wisely.domain.Person; 


@RestController 
public class DataController { 
//1 Spring Data JPA 已 自动 为 你 注册 bean， 所 以 可 自动 注入 
@Autowired 
PersonRepository personRepository; 
JAR 
* 保存 


* _ Save 支持 批量 保存 : «S extends T» Iterable 


«S» save(Iterable 
«S» entities); 
* 


* 删除 : 

* 文 持 使 用 id 删 除 对 象 、 批 量 删 除 以 及 删除 全 部 : 
* void delete(ID id); 

* void delete(T entity); 

* void delete(Iterable 


«? extends T» entities); 
* void deleteAll(); 
* 
a 
QRequestMapping("/save") 
public Person save(String name,String address,Integer age) 


Person p - personRepository.save(new Person(null, 
name, age, address)); 


return p; 


[** 
* 测试 findByAddress 
t7 
QRequestMapping("/q1") 
public List«Person» qi(String address)( 


List«Person» people - 
personRepository.findByAddress(address); 


return people; 


j 


JEK 

* 测试 findByNameAndAddress 
QRequestMapping("/q2") 
public Person q2(String name,String address) { 


Person people - 
personRepository.findByNameAndAddress(name, address); 


return people; 


j 


JER 
* 测试 withNameAndAddressQuery 
*/ 
QRequestMapping("/q3") 
public Person q3(String name,String address) { 


Person p = 
personRepository.withNameAndAddressQuery(name, address); 


return p; 


} 


/** 
* 测试 withNameAndAddressNamedQuery 
*/ 
QRequestMapping("/q4") 
public Person q4(String name,String address)( 


Person p = 
personRepository.withNameAndAddressNamedQuery(name, address); 


return p; 


) 

/ kk 
* 测试 排序 
rA 


QRequestMapping("/sort") 
public List<Person> sort()( 


List«Person» people - personRepository.findAll(new 
Sort(Direction.ASC, "age")); 


return people; 


j 

JER 
* 测试 分 页 
*/ 


QRequestMapping("/page") 
public Page<Person> page(){ 


Page<Person> pagePeople = personRepository.findAll(new 
PageRequest(1, 2)); 


return pagePeople; 


下 面 分 别 访问 地 址 测试 运行 效果 。 


访问 http:Wlocalhost: 8080/save? 
name=dd&address= 上 海 &age=25， 如 图 8-23 所 示 。 


i 


@ localhost:8080/save?na x Y d 
€ c localhost:8080/save?name=dd&address= +38 


Al8-23 ”访问 http://localhost: 8080/save? 
name=dd&address= 上 海 &age=25 


访问 http:/localhost: 8080/q1? address= 合 肥 ， 
如 图 8-24 所 示 。 


了 @ localhost:8080/ql?addr x 


€ C D localhost:8080/q1?address= 合 肥 


图 8-24 访问 : http://localhost: 8080/q1? address= 合 肥 


访问 http:Wlocalhost: 8080/q2? address= 合 肥 
&name= 汪 云 飞 ， 如 图 8-25 所 示 。 


€ QC | D localhost:8080/q2?address- &iBB&name-iEz € 


J @ localhost:8080/q2?addr x \_ 


图 8-25 ”访问 http://localhost: 8080/q2? address= 合 肥 
&mname= 汪 云 飞 


访问 http:Wlocalhost: 8080/q3? address= 合 肥 
&name= 汗 云 飞 ， 如 图 8-26 所 示 。 


- 2 má 
留 st 8080/q3?addr x 
| C | D localhost:8080/q3?address- &iB&name -itzs 三 | 


uM 


图 8-26 ”访问 http://localhost: 8080/q3? address= 合 肥 
&mname= 汪 云 飞 


访问 http://localhost: 8080/q4* address= 合 肥 
&name= 汪 云 飞 ， 如 图 8-27 所 示 。 


€ QC | D localhost:8080/g4?address- &iBB&name-;Ez € 


[ @ localhost:8080/q4?addr x WY 


色 8-27 ”访问 http://localhost: 8080/q4? address= 合 肥 
&name= 汪 云 飞 


访问 http://localhost: 8080/sort， 如 图 8-28 所 


@ localhost:8080/sort 


€ > C' [3localhost:8080/sort 


{ 
“2 


~ 


"age" : 2 
"address" : 


图 8-28 ”访问 http:Wlocalhost: 8080/sort 


V;lH]http://localhost: 8080/page， 如 图 8-29 所 
ZK œ 


RE — > 
y e localhost:8080/page x 
€ CQ | D localhost:8080/page 


"content" : [ 1 
"ad. 29, 


3 
“ide 2330, 

“name” : “bb” 
“age” : 27, 
"address" : " 

] 1; 

"totalPages" : 4, 
"totalElements" : T, 
"last" : false, 
“size” : 2, 
"number" : 1, 
"sort" : null, 
"first" : false, 
"mnumberOfElements" : 2 

} 


图 8-29 ”访问 http://localhost: 8080/page 
7. 目 定义 Repository 实 现 


上 而 的 实战 演示 已 经 包含 了 Spring Boot 和 
Spring Data JPA 组 合 的 绝 大 多 数 功 人 能。 下 面 我 们 将 
结合 Specification 和 目 定 义 Repository 实 现 来 定制 一 
个 目 动 模糊 查询 。 即 对 于 任意 的 实体 对 象 进行 得 
询 ， 对 象 里 有 几 个 值 我 们 束 查 儿 个 值 ， 当 值 为 字符 
型 时 我 们 就 目 动 like 人 查询， 其余 的 类 型 使 用 日 动 等 
TEW, WARM MAAR ° 


(1) «E Y. Specification: 


package com.wisely.specs; 
import static com.google.common.collect.Iterables.toArray; 


import java.lang.reflect.Field; 
import java.util.ArrayList; 
import java.util.List; 


import javax.persistence.EntityManager; 

import javax.persistence.criteria.CriteriaBuilder; 
import javax.persistence.criteria.CriteriaQuery; 
import javax.persistence.criteria.Predicate; 

import javax.persistence.criteria.Root; 

import javax.persistence.metamodel.Attribute; 

import javax.persistence.metamodel.EntityType; 

import javax.persistence.metamodel.SingularAttribute; 


import org.springframework.data.jpa.domain.Specification; 
import org.springframework.util.ReflectionUtils; 
import org.springframework.util.StringUtils; 


public class CustomerSpecs { 


public static «T» Specification<T> byAuto(final 
EntityManager entityManager, final T example) { //1 


final Class<T> type = (Class<T>) 
example.getClass();//2 


return new Specification<T>() { 


@Override 
public Predicate toPredicate(Root<T> root, 
CriteriaQuery<?> query, CriteriaBuilder cb) { 
List<Predicate> predicates = new ArrayList<> 
(); 7/3 


EntityType<T> entity = 
entityManager.getMetamodel().entity(type);//4 


for (Attribute<T, ?> attr 
entity.getDeclaredAttributes()) {//5 
Object attrValue = getValue(example, 
attr); //6 
if (attrValue != null) { 
if (attr.getJavaType() == 


String.class) ( //7 
if 
(!StringUtils.isEmpty(attrValue)) ( //8 


predicates.add(cb.like(root.get(attribute(entity, 
attr.getName(), String.class)), 
pattern((String) 
attrValue))); //9 
j 
} else { 
predicates.add(cb.equal(root.get(attribute(entity, 
attr.getName(), attrValue.getClass())), 
attrValue)); //10 
j 


j 
return predicates.isEmpty() ? cb.conjunction() 
: cb.and(toArray(predicates, Predicate.class));//11 


JER 
* 12 
*/ 
private <T> Object getValue(T example, 
Attribute<T, ?> attr) { 
return ReflectionUtils.getField((Field) 
attr.getJavaMember(), example); 


/** 
* 13 
*/ 
private <E, T> SingularAttribute<T, E> 
attribute(EntityType<T> entity, String fieldName, 
Class<E> fieldClass) { 
return 
entity.getDeclaredSingularAttribute(fieldName, fieldClass); 


H 


static private String pattern(String str) ( 
return "e" + str + "96"; 


j 


代码 解释 

(定义 一 个 返回 值 为 Specification 的 方法 
byAuto， 这 里 使 用 的 是 这 型 T， 所 以 这 个 
Specification 古 可 以 用 于 任意 的 实体 类 的 。 它 接受 的 
参数 是 entityManager 和 当前 的 包含 值 作 为 查询 条 件 
的 实体 类 对 象 。 

(获得 当前 实体 类 对 象 类 的 类 型 。 

G) 源 建 Predicate 列 表 存 储 构 造 的 查询 条 件 。 


由 获得 实体 类 的 Entity Type, 我 们 可 以 从 
EntityType 获 得 实体 类 的 属性 。 


二 对 实体 类 的 所 有 属性 做 循环 。 
OAR FEE MAAN BR PIB ERIE ° 
CO 当前 属性 值 为 字符 类 型 的 时 候 。 
(8 名 当 前 子 符 不 为 空 的 情况 下 。 


(9 构造 当 前 属性 like (前 后 %) 属性 值 查询 条 
Tr, ARMER ENRE * 


dd 其余 情况 下 ， 构 造 属性 和 属性 值 equal] 碍 询 条 
fe, MME PIA S 


UW 将 条 件 列表 转换 成 Predicate。 


" 49 通 过 反射 获得 实体 类 对 象 对 应 属性 的 属性 


U3 获得 实体 类 的 当前 属性 的 SingularAttribute， 
SingularAttribute 包 含 的 是 实体 类 的 某 个 单独 属性 


(9 构造 like 的 查询 模式 ， 即 前 后 加 %。 
(2) 定义 接口 : 


package com.wisely.support; 
import java.io.Serializable; 


import org.springframework.data.domain.Page; 

import org.springframework.data.domain.Pageable; 

import org.springframework.data.jpa.repository.JpaRepository; 
import 
org.springframework.data.jpa.repository.JpaSpecificationExecut 
or; 

import org.springframework.data.repository.NoRepositoryBean; 


@NoRepositoryBean 

public interface CustomRepository<T, ID extends 
Serializable>extends JpaRepository<T, ID> 

, JpaSpecificationExecutor«T»( 


Page<T> findByAuto(T example,Pageable pageable); 


TORO REESE 


此 例 中 的 接口 继承 了 JpaRepository， 让 我 们 具 
备 了 JpaRepository 所 提供 的 方法 继承 了 
JpaSpecificationExecutor， 让 我 们 具备 使 用 
Specification 上 的 能 力 。 


(3) 定义 实现 : 


package com.wisely.support; 
import java.io.Serializable; 
import javax.persistence.EntityManager; 


import org.springframework.data.domain.Page; 

import org.springframework.data.domain.Pageable; 

import 
org.springframework.data.jpa.repository.support.SimpleJpaRepos 
itory; 


import static com.wisely.specs.CustomerSpecs.*; 


public class CustomRepositoryImpl «T, ID extends Serializable» 
extends SimpleJpaRepository<T, ID» 
implements CustomRepository<T,ID> { 


private final EntityManager entityManager; 


public CustomRepositoryImpl(Class«T» domainClass, 
EntityManager entityManager) { 
super(domainClass, entityManager); 
this.entityManager - entityManager; 


@Override 
public Page<T> findByAuto(T example, Pageable pageable) { 
return findAll(byAuto(entityManager, 
example), pageable) ; 
j 


j 
代码 解释 


此 类 继承 JpaRepository 的 实现 类 
SimpleJpaRepository， 让 我 们 可 以 使 用 
SimpleJpaRepository 的 方法 ;此 类 当然 还 要 实现 我 
们 目 定 义 的 接口 CustomRepository ° 


findByAuto 方 法 使 用 byAuto Specification 构 造 的 
条 件 查 询 ， 并 提供 分 页 功能 。 


(4) 定义 repositoryFactoryBean: 


package com.wisely.support; 
import java.io.Serializable; 
import javax.persistence.EntityManager; 


import org.springframework.data.jpa.repository.JpaRepository; 
import 
org.springframework.data.jpa.repository.support.JpaRepositoryF 
actory; 

import 
org.springframework.data.jpa.repository.support.JpaRepositoryF 
actoryBean; 

import 
org.springframework.data.jpa.repository.support.SimpleJpaRepos 
itory; 

import 
org.springframework.data.repository.core.RepositoryInformation 


, 


Import 
org.springframework.data.repository.core.RepositoryMetadata; 
import 
org.springframework.data.repository.core.support.RepositoryFac 
torySupport; 


public class CustomRepositoryFactoryBean<T extends 
JpaRepository<S, ID», S, ID extends Serializable> 
extends JpaRepositoryFactoryBean<T, S, ID» { 


@Override 
protected RepositoryFactorySupport 
createRepositoryFactory(EntityManager entityManager) { 
return new CustomRepositoryFactory(entityManager); 
} 


private static class CustomRepositoryFactory extends 
JpaRepositoryFactory { 


public CustomRepositoryFactory(EntityManager 
entityManager) { 
super(entityManager); 


j 


@Override 

@SuppressWarnings({"unchecked"} ) 

protected <T, ID extends Serializable> 
SimpleJpaRepository<?, ?» getTargetRepository( 

RepositoryInformation information, 
EntityManager entityManager) ( 
return new CustomRepositoryImpl<T, ID>((Class<T>) 

information.getDomainType(), entityManager); 


j 


@Override 
protected Class<?> 
getRepositoryBaseClass(RepositoryMetadata metadata) { 
return CustomRepositoryImpl.class; 
} 


TORO HENE 


在 8.2.1 中 我 们 对 定义 RepositoryFactoryBean 做 
了 讲解 ， 这 里 的 代码 大 可 以 作为 模板 代码 使 用 ， 只 
需 修改 和 定义 实现 类 相关 的 代码 即 可 。 


(5) 使 用 : 


package com.wisely.dao; 
import java.util.List; 


import org.springframework.data.jpa.repository.Query; 
import org.springframework.data.repository.query.Param; 


import com.wisely.domain.Person; 
import com.wisely.support.CustomRepository; 


public interface PersonRepository extends 
CustomRepository<Person, Long» { 


List<Person> findByAddress(String address); 

Person findByNameAndAddress(String name,String address); 

@Query("select p from Person p where p.name= :name and 
p.address= :address") 

Person withNameAndAddressQuery(@Param("name")String 
name, QParam("address")String address); 

Person withNameAndAddressNamedQuery(String name,String 
address); 


) 
INR ERE 
只 需 让 实体 类 Repository 继 承 我 们 目 定义 的 


Repository 接 口 ， 即 可 使 用 我 们 在 目 定 义 Respository 
中 实现 的 功能 。 


package com.wisely.web; 
import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.data.domain.Page; 

import org.springframework.data.domain.PageRequest; 

import org.springframework.data.domain.Sort; 

import org.springframework.data.domain.Sort.Direction; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 


import com.wisely.dao.PersonRepository; 
import com.wisely.domain.Person; 


@RestController 
public class DataController { 


QRequestMapping("/auto") 
public Page<Person> auto(Person person)( 


Page<Person> pagePeople = 
personRepository.findByAuto(person, new PageRequest(0, 10)); 


return pagePeople; 


代码 解释 


控制 器 中 接受 一 个 Person 对 象 ， 当 Person 的 
-— 人 时 ， 会 目 动 对 name 进 行 like 碍 询 ， 当 age 有 
IET 进行 等 于 查询 ; 当 Person 中 有 多 个 值 不 为 

ZS A ii. 会 目 动 构造 多 个 查询 条 件 ;， 当 Person 所 
有 值 为 空 鸭 时 候 ， 默 认 碍 询 出 所 有 记录 ° 


此 处 需要 特别 指出 的 是 ， 在 实体 类 中 定义 的 数 
据 类 型 要 用 包 冯 类 型 (Long ^ Integer) ， 而 不 能 使 


用 原始 数据 类 型 (long^inO 。 因 为 在 Spring MVC 
中 ， 使 用 原始 数据 类 型 会 目 动 初始 化 为 0， 而 不 是 
zx. LESE DREAM e 


(6) 配置 : 


package com.wisely; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.SpringApplication; 


import 
org.springframework.boot.autoconfigure.SpringBootApplication; 
import 
org.springframework.data.jpa.repository.config.EnableJpaReposi 
tories; 


import com.wisely.dao.PersonRepository; 
import com.wisely.support.CustomRepositoryFactoryBean; 


QSpringBootApplication 
QEnableJpaRepositories(repositoryFactoryBeanClass - 
CustomRepositoryFactoryBean.class) 
public class Ch82Application ( 

@Autowired 

PersonRepository personRepository; 


public static void main(String[] args) { 
SpringApplication.run(Ch82Application.class, args); 
j 


代码 解释 


在 配置 类 上 配置 @EnableJpaRepositories， 并 指 
定 repositoryFactoryBeanClass， 让 我 们 目 定 义 的 
Repository 实 现 起 歼 。 


如 果 我 们 不 需要 自 定 义 Repository 实 现 ， 则 在 
Spring Data JPA 里 无 须 凑 加 @EnableJpaRepositories 
注解 ， 因 为 @SpringBootApplication 包 含 的 
@EnableAutoConfiguration 注 解 已 经 开局 了 对 Spring 
Data JPA] X YF ° 
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访问 http://localhost: 8080/auto， 无 构造 查询 条 
件 ， 查 询 全 部 ， 如 图 8-30 所 示 。 


/ @ localhost:8080/auto x V3 


€ > Q |B localhost:8080/auto 


"totalElements" : 
“size” : 10, 

"number" : 0, 
"mumberOfElements" : 7, 
"sort" : rull, 

"first" : true 


图 8-30 无 构造 查询 条 件 


访问 http:Wlocalhost: 8080/auto? address= 肥 ， 
构造 address 的 like 查 询 ， 如 图 8-31 所 示 。 


g localhost:8080/auto?ad x 


€ C | [5 localhost:8080/auto?address - BE 


"content" : [ i 


S: 

"id" : 26, 
"name" : “SEZ 
"age" : 32, 
"address" : “ 
] 


LI 
"last" : true, 
"totalPages" : 1, 
"totalElements" : 2, 
“size” : 10, 
"number" : 0, 
"numberOfElements" : 2, 
"sort" : rull, 
"first" : true 


图 8-31 构造 address 的 like 查 询 


访问 http://localhost: 8080/auto? address-HE 
&name-zz&age-32, fjj&addressH'likefrit] ^ name 
的 like 查 询 以 及 age 的 equal 查 询 ， 如 图 8-32 所 示 。 


"totalPages" : 
"totalElements" : 


"size" : 10, 

"number" : 0, 
"numberOfElements" : 1, 
"sort" : mull, 

"first" : true 


图 8-32 ”构造 address 的 like 查 询 、name 的 like 查 询 以 及 age 的 
equal 查 询 


8.3 Spring Data REST 


8.3.1 点睛 Spring Data REST 


(1) 什么 是 Spring Data REST 


Spring Data JPAzé 4 T Spring DataflJrepository 
之 上 ， 可 以 将 repository 目 动 输出 为 REST 资 源 。 日 
前 Spring Data REST 文 持 将 Spring Data JPA ^ 
Spring Data MongoDB ^ Spring Data Neo4j ` Spring 
Data GemFire 以 及 Spring Data Cassandra 的 
repository 目 动 转换 成 REST 上 服务 。 


(2) Spring MVC 中 配置 使 用 Spring Data 
REST 


Spring Data REST 的 配置 是 定义 在 
RepositoryRestMvcConfiguration 
(org.springframework.data.rest.webmvc.config.Rep 
ositoryRestMvcConfiguration) 配置 类 中 已 经 配置 
好 了 ， 我 们 可 以 通过 继承 此 类 或 者 直接 在 目 己 的 
配置 类 上 @Import 此 配置 类 。 


1) 继承 方式 演示 : 


QConfiguration 
public class MyRepositoryRestMvcConfiguration extends 
RepositoryRestMvcConfiguration ( 
QOverride 
public RepositoryRestConfiguration config() { 
return super.config(); 


// 其 他 可 重 写 以 config 开 头 的 方法 


2) 导入 方式 演示 : 


QConfiguration 
QImport(RepositoryRestMvcConfiguration.class) 
public class AppConfig { 


} 
因 在 Spring MVC 中 使 用 Spring Data REST 和 在 


Spring Boot 中 使 用 方式 是 一 样 的 ， 因 此 我 们 将 在 
实战 环节 讲解 Spring Data REST 。 


8.3.2 Spring Boot 的 文 持 


Spring Boot 对 Spring Data REST 的 自动 配置 放 
置 在 Rest 中 ， 如 图 8-33 所 示 。 


4 # rest 


- tù RepositoryRestMvcAutoConfiguration.class 
t» SpringBootRepositoryRestMvcConfiguration.class 


图 8-33 Restk 


SpringBootRepositoryRestMvcConfiguration2Zs ^J Jf 
码 我 们 可 以 得 出 ，Spring Boot 已 经 为 我 们 目 动 配 
置 了 RepositoryRestConfiguration， 所 以 在 Spring 
Boot 中 使 用 Spring Data REST 只 需 引 入 spring-boot- 
starter-data-rest 的 依 顿 ， 无 须 任 何 配置 即 可 使 用 。 


Spring Boot 通 过 在 application.properties 中 配置 
以 “spring.data.rest 为 前 绥 的 属性 来 配置 
RepositoryRestConfiguration， 如 图 8-34 所 示 。 


spring.data.rest.base-path : java.net.URI 
spring.data.rest.default-page-size : int 
spring.data.rest.limit-param-name : String 
spring.data.rest.max-page-size : int 
spring.data.rest.page-param-name : String 
spring.data.rest.return-body-on-create : boolean 
spring.data.rest.return-body-on-update : boolean 


图 8-34 配置 RepositoryRestConfiguration 


8.3.3 ”实战 


(1) 新 建 Spring Boot 项 目 。 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA (spring- 
boot-starter-data-jpa) 和 Rest Repositories (spring- 
boot-starter-data-rest) 。 


项 E 信息 : 


groupId: com.wisely 
arctifactId:ch8 3 
package: com.wisely.ch8 3 


添加 Oracle JDOBCZXz/j, FE 
MP PRSE 性 ， 与 上 例 保 持 一 
TN o 


(2) 实体 类 : 


package com.wisely.ch8 3.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 

public class Person ( 
QId 
QGeneratedValue 
private Long id; 


private String name; 
private Integer age; 
private String address; 


public Person() ( 
super(); 


public Person(Long id, String name, Integer age, String 
address) { 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 
this.address - address; 


} 
//iáli&getter ` setter 
} 


(3) 实体 类 的 Repository: 


package com.wisely.ch8 3.dao; 


import 
org.springframework.data.jpa.repository.JpaRepository; 


import com.wisely.ch8 S3.domain.Person; 


public interface PersonRepository extends 
JpaRepository«Person, Long» ( 


Person findByNameStartsWith(String name); 


(4) 安装 Chrome 插 件 Postman REST Client ° 


Postman 是 一 个 文 持 REST 的 客户 端 ， 我 们 可 
以 用 它 来 测试 我 们 的 REST 资 源 。 


本 方 将 会 Postman 揪 件 放 在 源码 中 ， 下 面 讲解 
Postman 在 Chrome 下 的 安装 方式 ， 这 与 在 Chrome 
浏览 万 下 安 竣 其 他 插件 是 一 致 的 。 Postman 插 件 放 
T ZKpqagsrc/main/resurces H 5€ F ° 


本 书 使 用 的 Chrome 版 本 是 43.0，Postman 挨 本 
是 3.0.4。 痢 版 本 的 Chrome 限 制 非 Chrome 应 用 商店 
的 插件 安装 。 下 面 米 安 狂 Postman 捅 件 。 


JU 用 解压 缩 软 件 打 开 postman.crx， 并 解压 到 
任意 目 孙 ， 如 图 8-35 所 示 。 


test runner 
test runner tester 
tester sandbox 


Sibackground template 
SX)background template test 
embedded_ga 


6 embedded_ga_host 
embedded_ga_host 
"X)embedded ga host 
$)ga details 
W icon 
& icon, 16 
WW icon 32 
& icon 48 
& icon 64 
W icon 128 
index 
manifest json 
requester 


图 8-35 ”打开 postman.crx 


将 _metadata 文 件 夹 名 称 修改 为 metadata ° 


打开 Chrome 软 件 ， 设 置 ~ 扩 展 程 序 ， 打 开 *“ 开 
发 者 模式 ”， 并 从 “加 载 正在 开发 的 扩展 程序 ...” 加 
载 我 们 刚才 解压 的 目录 ， 如 图 8-36 所 示 。 


RRP RV See. 


Bg 我 的 视频 
k 我 的 图 片 


ZIA): postman 


PARK EK OD gi 


图 8-36 ”加 载 Postman 


安 狼 完成 后 的 效 来 如 图 8-37 所 示 。 


Chrome 扩展 程序 w Fame 
3 eter Res. || Stm. IBI RES 


E 试 试 全 Chrome 


ID : jnodapbokmgldoemmljgifcineapgojp 


m ”获取 更 多 扩展 程序 


图 8-37 “加载 完成 


(3) 在 Chrome 地 址 栏 输入 “chrome: /Wapps”， 可 
看 到 Postman， 如 图 8-38 所 示 。 


J 8: REFS 
| e 


x 
c Eb chrome//apps | 


a D 


E 


尚未 登录 Chrome 
( 无 法 同步 - SR) 


Chrome Kj... | Postman 


Chrome 网 上 应 用 店 A 


图 8-38 ”通过 Chrome 查 看 Postman 


或 者 通过 Chrome 提 供 的 快捷 方式 打开 ， 如 
8-39 所 示 。 


Chrome — Chrome, | Postman 
| 


图 8-39 通过 Chrome 提 供 的 快捷 方式 打开 Postman 


Postman 有 的 界面 如 图 8-40 所 示 。 


图 8-40 Postman% M 


5.REST 服 务 测试 


在 这 里 我 们 使 用 Postman 测 试 REST 资 源 服 


务 o 
(1) jQuery 


在 实际 开发 中 ， 在 jQuery 我 们 使 用 $.ajax 方 法 
的 type 属 性 来 修改 提交 方法 : 


$.ajax({ 
type: "GET", 
dataType: "json", 
url: "http://localhost:8080/persons ", 
success: function(data) { 
alert(data); 


} 
4); 


(2) AngularJS 
在 实际 开发 中 ， 可 以 使 用 $http 对 象 来 操作 


$http.get(url) 
$http.post(url,data) 
$http.put(url,data) 


$http.delete(url) 


(3) 列表 


在 实际 开发 中 ， 在 Postman 中 使 用 GET 访 问 
http://localhost: 8080/persons， 获 得 列表 数据 ， 如 
图 8-41 所 示 。 


图 8-41 ”获得 列表 数据 
(4) 获取 单一 对 象 


在 Postman 中 使 用 GET 访 问 http:Wlocalhost: 
8080/1， 获 得 id 为 1 的 对 象 ， 如 图 8-42 所 示 。 


sk 


am ERAN 


图 8-42 ”获得 id 为 1 的 对 象 


在 上 面 的 目 定 义 实体 类 Repository 中 定义 了 
findByNameStartsWith 方 法 ， 知 想 此 方法 世 桑 露 为 
REST ety, ar CA PEP: 


public interface PersonRepository extends 
JpaRepository<Person, Long> { 


@RestResource(path = "nameStartsWith", rel = 


"nameStartsWith") 
Person findByNameStartsWith(QParam("name")String name); 


j 


此 时 在 Postman 中 使 用 GET 访 问 
http://localhost: 
8080/persons/search/nameStartsWith? name=Y£, "J 
实现 查询 操作 ， 如 图 8-43 所 示 。 


(6) 分 页 
在 Postman 中 使 用 GET 访 问 http:/localhost: 


8080/persons/? page=1&size=2，page=1 即 第 二 
页 ，size=2 即 每 页 数量 为 2， 如 图 8-44 所 示 。 


图 8-43 ”回应 现 查 询 操 作 


图 8-44 fü 
从 返回 结 采 可 以 看 出 ， 我 们 不 仅 能 获得 当前 
分 页 的 对 象 ， 而 且 还 给 出 了 我 们 上 一 页 、 下 一 
页 、 第 一 页 、 最 后 一 页 的 REST 资 源 路 径 。 


(7) 排序 


在 Postman 中 使 用 GET 访 癌 localhost: 
8080/persons/? sort=age，desc， 即 按照 age 属性 倒 
序 ， 如 图 8-45 所 示 。 


图 8-45 ”排序 


(8) 保存 

[AJhttp://localhost: 8080/persons 发 起 POST 请 
求 ， 将 我 们 要 体 存 的 数据 放置 在 请 求 体 中 ， 数 据 
类 型 设置 为 JSON，JSON 内 容 如 图 8-46 所 示 。 


("name":"cc", "address": "成都", "age":24} 


图 8-46 ”保存 


通过 输出 可 以 看 出 ， 保 存 成 功 后 ， 我 们 的 新 
数据 的 id 为 21 © 


(9) 更 新 
现在 我 们 更 新 新 增 的 id 为 21 的 数据 ， 用 PUT 方 
式 访 问 http:/localhost: 8080/persons/21， 并 修改 提 
交 的 数据 ， 如 图 8-47 所 示 。 


("name":"cc2", "address": "成都", "age" :23} 


Sta (eyes) = @ m £ 9 
=. mane 
| - EGS 
ES <>)(5 
图 8-47 更 新 


从 输出 我 们 可 以 看 出 ， 数 据 更 新 已 成 功 。 
(10) 删除 
在 这 一 步 我 们 删除 刚才 新 增 的 id 为 21 的 数 


据 ， 使 用 DELETE 方 式 访 问 http:/localhost: 
8080/persons/21， 如 图 8-48 所 示 。 


图 8-48 ”删除 


此 时 再 用 GET 方 陈 访问 http:/localhost: 
8080/persons/21， 如 图 8-49 所 示 。 


图 8-49 获取 失败 


返回 结果 为 404 Not Found, WPH PRIN AS 
REST 资 源 不 存在 。 


6. 定 制 
(1) 定制 根 路 径 
在 上 面 的 实战 例子 中 ， 我 们 访问 的 REST 资 源 
的 路 径 是 在 根 目 了 永 下 的 ， 即 http:Wlocalhost: 
8080/persons， 如 采 我 们 需要 定制 根 路 人 径 的 话 ， 只 


需 在 Spring Boot 的 application.properties 下 增加 如 下 
定义 即 可 : 


spring.data.rest.base-path- /api 


此 时 REST 资 源 的 路 径 变 成 了 http://localhost: 
8080/api/persons ° 


(2) 定制 节点 路 径 


上 上 例 实 成 中 ， 我 们 的 和 点 路 径 为 
http://localhost: 8080/persons， 这 是 Spring Data 
REST 的 默认 规划， 束 是 在 实体 类 之 后 加 “s” 来 形成 
路 径 。 我 们 知道 person 的 复数 是 people 而 不 是 
persons， 在 类 似 的 情况 下 要 对 映射 的 名 称 进 行 修 
改 的 话 ， 我 们 需 要 住 实体 类 Repository 上 使 用 
@RepositoryRestResource 注 解 的 path 属 性 进行 修 
改 ， 代 码 如 下 : 


QRepositoryRestResource(path = "people") 
public interface PersonRepository extends 
JpaRepository«Person, Long» { 


QRestResource(path = "nameStartsWith", rel = 


"nameStartsWith") 
Person findByNameStartsWith(QParam("name")String name); 


此 时 我 们 访问 REST 服 务 的 地 址 变 为 : 
http://localhost: 8080/api/people ° 


8.4 ARS 
8.4.1 Spring 的 事务 机 制 


所 有 的 数据 访问 技术 都 有 事务 处 理 机 制 ， 这 
些 拷 术 提 供 了 API 用 来 开局 事务 、 提 区 事务 来 完成 
数据 操作 ， 或 者 在 发 生 错 误 的 时 候 回 深 数 据 。 


而 Spring 的 事务 机 制 古 用 统一 的 机 制 来 处 理 不 
同 数据 访问 技术 的 事务 处 理 。Spring 的 事务 机 制 提 
供 了 一 个 PlatformTransactionManager 接 口 ， 不 同 
的 数据 访问 技术 的 事务 使 用 不 同 的 接口 实现 ， 如 
表 8-3 所 示 。 


表 8-3 ”数据 访问 技术 及 实现 


数据 访问 技术 x H 


TIEF FF XE MS SE SR APCS T : 


QBean 
public PlatformTransactionManager transactionManager() { 


JpaTransactionManager transactionManager - new 

JpaTransactionManager(); 
transactionManager.setDataSource(dataSource()); 
return transactionManager; 


84.2 Pim RS 


Spring 文 持 声名 式 事务 ， 即 使 用 注解 来 选择 需 
要 使 用 事务 的 方法 ， 它 使 用 @Transactional 注 解 在 
方法 上 表明 该 方法 需要 事务 文 持 。 这 是 一 个 基于 
AOP 的 实现 操作 ， 羡 者 可 以 重 温 1.3.3 广 中 使 用 注 
解 式 的 拦截 方式 来 理解 Spring 的 声名 式 事务 。 被 注 
解 的 方法 在 被 调用 时 ，Spring 开 启 一 个 新 的 事务 ， 
| 方法 无 异常 运行 结束 后 ，Spring 会 提交 这 个 事 
务 。 

@Transactional 


public void saveSomething(Long id, String name) { 


// 数 据 库 操作 


在 此 处 需要 特别 注意 的 是 ， 此 @Transactional 
注解 来 目 org.springframework.transaction.annotation 
包 ， 而 不 是 javax.transaction ° 


Springi tt Jj e 
@OEnableTransactionManagement 注 解 在 配置 类 上 来 
开局 声名 式 事 务 的 文 持 。 使 用 了 
(QEnableTransactionManagement/G, Spring ře 
EH aH fO@Transactional h T EMAR -° 
@EnableTransactionManagement 上 的 使 用 方式 如 下 : 


QConfiguration 
QEnableTransactionManagement 
public class AppConfig { 


) 
8.4.3 ”注解 事务 行为 

@Transactional 有 如 表 8-4 所 示 的 属性 来 定制 事 
务 行为 。 


表 8-4 _@Transactional 的 属性 


属 性 


a X 


默认 值 


propagationtion 


isolation 


isolation 


Propagation 定义 了 事务 的 生命 周期 ， 主 要 有 以 下 选项 


REQUIRED: 方法 A 调用 时 没有 事务 新 建 一 个 事务 ， 当 在 方法 
A 调用 另外 一 个 方法 B 的 时 候 ,方法 B 将 使 用 相同 的 事务 ;如果 
方法 B 发 生 异 常 需要 数据 回 滚 的 时 候 ， 整 个 事务 数据 回 滚 


REQUIRES NEW: 对 于 方法 A 和 B, 在 方法 调用 的 时 候 无 论 是 
否 有 事务 都 开启 一 个 新 的 事务 ; 这 样 如 果 方 法 B 有 异常 不 会 导致 
方法 A 的 数据 回 深 


NESTED: 和 REQUIRES_NEW 类 似 , 但 支持 JDBC, 不 支持 JPA 
或 Hibernate 


SUPPORTS: 方法 调用 时 有 事务 就 用 事务 ， 没 事务 就 不 用 事务 
NOT SUPPORTED: 强制 方法 不 在 事务 中 执行 ， 若 有 事务 ， 在 
方法 调用 到 结束 阶段 事务 都 将 会 被 挂 起 
NEVER: 强制 方法 不 在 事务 中 执行 ， 若 有 事务 则 抛 出 异常 
MANDATORY: 强制 方法 在 事务 中 执行 ， 若 无 事务 则 抛 出 异常 
Isolation ( 隔离 ) 决定 了 事务 的 完整 性 ， 处 理 在 多 事务 对 相同 数 
据 下 的 处 理 机 制 , 主要 包含 下 面 的 隔离 级 别 C 当然 我 们 也 不 可 以 随 
意 设置 ， 这 要 看 当前 数据 库 是 否 支 持 ) 


READ_UNCOMMITTED: 对 于 在 A 事务 里 修改 了 一 条 记录 但 没 


有 提交 事务 , 在 B 事务 可 以 读 取 到 修改 后 的 记录 。 
不 可 重复 读 以 及 幻 读 


可 导致 脏 读 、 


READ COMMITTED: 只 有 当 在 A 事务 里 修改 了 一 条 记录 是 提 
LES Ia, B 事务 才 可 以 读 取 到 提交 后 的 记录 ; 阻止 脏 读 , 但 可 
能 导致 不 可 重复 读 和 幻 读 


£ 义 

REPEATABLE_READ: 不 仅 能 实现 READ_COMMITTED 的 功 
能 ， 而 且 还 能 阻止 当 A 事务 读 取 了 一 条 记录 ，B 事务 将 不 允许 修 
改 这 条 记录 ; 阻止 脏 读 和 不 可 重复 读 ， 但 可 出 现 幻 读 

SERIALIZABLE: 此 级 别 下 事务 是 顺序 执行 的 , 可 以 避免 上 述 级 
别 的 缺陷 ,但 开销 较 大 

DEFAULT: 使 用 当前 数据 计 
Server 是 READ_COMMITTED; 


HEU SHES RAHI, 如 Oracle, SQL 
Mysql fi REPEATABLE_READ 


REQUIRED 


DEFAULT 


默认 值 


DEFAULT 


续 表 


timeout 


readOnly 


timeout 指定 事务 过 期 时 间 ， 


指定 当 Meg 


默认 为 当前 数据 库 的 事务 过 期 时 间 


前 事务 是 否 是 只 读 事 务 


TIMEOUT_DEFAULT 


false 


rollbackFor 


指定 哪个 或 者 哪些 异常 可 以 引起 事务 回 深 


Throwable 的 子 类 


noRollbackFor 


指定 哪个 或 者 哪些 异常 不 可 以 引起 事务 回 深 


类 级 别 使 用 @Transactional 


Throwable 的 子 类 


@Transactional 不 仅 可 以 注解 在 方法 上 ， 也 可 
以 注解 在 类 上 。 当 注解 在 类 上 的 时 候 音 味 看 此 类 
的 所 有 public 方 法 都 是 开局 事务 的 。 如 采 类 级 别 和 
方法 级 别 同时 使 用 了 @Transactional 注 解 ， 则 使 用 
在 类 级 别 的 注解 会 重 载 方法 级 别 的 注解 。 


8.4.5 Spring Data JPA 的 事务 支持 


Spring Data JPA 对 所 有 的 默认 方法 都 开局 了 事 
务 文 持 ， 且 和 查询 类 事务 默认 局 用 readOnly=true 属 
性 。 


这 些 我 们 在 SimpleJpaRepository 的 源码 中 可 以 
看 下， 下 和 面 束 来 看 看 缩减 的 SimpleJpaRepository 有 J 
YEAS : 


@Repository 
@Transactional(readOnly = true) 
public class SimpleJpaRepository<T, ID extends Serializable> 
implements JpaRepository<T, ID>, 
JpaSpecificationExecutor<T> ( 


@Transactional 

public void delete(ID id) {} 

@Transactional 

public void delete(T entity) {} 

@Transactional 

public void delete(Iterable<? extends T> entities) {} 
@Transactional 

public void deleteInBatch(Iterable<T> entities) {} 
@Transactional 


public void deleteAll() {} 

QTransactional 

public void deleteAllInBatch() {} 

public T findOne(ID id) {} 

QOverride 

public T getOne(ID id) {} 

public boolean exists(ID id) {} 

public List<T> findAll() {} 

public List<T> findAll(Iterable<ID> ids) {} 

public List<T> findAll(Sort sort) {} 

public Page<T> findAll(Pageable pageable) {} 

public T findOne(Specification<T> spec) {} 

public List<T> findAll(Specification<T> spec) {} 

public Page<T> findAll(Specification<T> spec, Pageable 
pageable) {} 

public List<T> findAll(Specification<T> spec, Sort sort) 


{} 
public long count() {} 
public long count(Specification<T> spec) {} 
@Transactional 
public <S extends T> S save(S entity) {} 
@Transactional 
public <S extends T> S saveAndFlush(S entity) {} 
@Transactional 
public <S extends T> List<S> save(Iterable<S> entities) 
{} 
@Transactional 
public void flush() {} 
} 


从 源码 我 们 可 以 看 出 ，SimpleJpaRepository 在 
类 级 别 定义 了 @Transactional (readOnly-true) , 
而 在 和 save、delete 相 天 的 操作 重 写 了 
@Transactional 必 性 ， 此 时 readOnly 必 性 是 false， 
其 余 查 询 操 作 readOnly 仍 然 为 false 。 


8.4.6 Spring Boot 的 事务 支持 


1. 目 动 配置 的 事务 管理 名 


在 使 用 JDBC 作 为 数据 访问 技术 的 时 候 ， 
Spring Boot 为 我 们 定义 了 
PlatformTransactionManagerf] 实现 
DataSourceTransactionManagerH'Bean; 配置 见 
org.springframework.boot.autoconfigure.jdbc.DataSo 
urceTransactionManagerAutoConfigurationZs FAY 


X: 


QBean 
@ConditionalOnMissingBean 
QConditionalOnBean(DataSource.class) 
public PlatformTransactionManager transactionManager() { 
return new 
DataSourceTransactionManager(this.dataSource); 


在 使 用 JPA 作 为 数据 访问 技术 的 时 候 ，Spring 
Boot 为 我 们 了 定义 一 个 PlatformTransactionManager 
的 实现 JpaTransactionManager 上 的 Bean; 配置 见 
org.springframework.boot.autoconfigure.orm.jpa.Jpa 
BaseConfiguration.class 类 中 的 定义 : 


QBean 


QConditionalOnMissingBean(PlatformTransactionManager.class) 
public PlatformTransactionManager transactionManager() { 


return new JpaTransactionManager(); 


2. 目 动 开 局 注解 事务 的 文 持 
Spring Boot 专 门 用 于 配置 事务 的 类 为 : 


org.springframework.boot.autoconfigure.transaction. 
TransactionAutoConfiguration， 此 配置 类 依赖 于 
JpaBaseConfiguration 和 DataSource 
TransactionManagerAutoConfiguration ° 


而 在 


DataSourceTransactionManagerAutoConfiguration#ic 


置 里 还 开局 了 对 声名 却 事 务 的 文 择 ， 代 但 如 下 : 


@ConditionalOnMissingBean(AbstractTransactionManagementConfi 
guration.class) 

@Configuration 

@EnableTransactionManagement 

protected static class 
TransactionManagementConfiguration { 


j 


所 以 在 Spring Boot 中 ， 无 须 显 示 开 局 使 用 


@EnableTransactionManagement 注 解 。 


8.4.7 “实战 


在 实际 使 用 中 ， 使 用 Spring Boot 默 认 的 配置 
束 能 满足 我 们 绝 大 多 数 需 求 。 在 本 三 的 实战 里 ， 
我 们 将 演示 如 何 使 用 @Transactional 使 用 异 利 导致 
数据 回 深 和 使 用 异常 让 数据 不 回 深 。 


1.3815 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA (spring- 
boot-starter-data-jpa) 和 Web (spring-boot-starter- 
web) 。 


项 z 信息 : 


groupId: com.wisely 
arctifactId:ch8_4 
package: com.wisely.ch8_4 


添加 Oracle JBBCZXz/J, FFE 
prone ， 写 上 例 保 持 一 
AW o 


2.5 p 2S 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 
public class Person ( 
QId 


QGeneratedValue 


private 
private 
private 


private 


Long id; 
String name; 
Integer age; 


String address; 


public Person() ( 
super(); 


public Person(Long id, String name, Integer age, String 


address) { 
super(); 
this.id = id; 
this.name = name; 
this.age = age; 
this.address = address; 


// getter ^ setter 


3.S- A Repository 


import 


org.springframework.data.jpa.repository.JpaRepository; 


import com.wisely.ch8_4.domain.Person; 


public interface PersonRepository extends 
JpaRepository<Person, Long> { 


4. 业 务 服务 Service 


(1) 服务 接口 : 


package com.wisely.ch8 4.service; 
import com.wisely.ch8 4.domain.Person; 


public interface DemoService ( 
public Person savePersonWithRollBack(Person person); 
public Person savePersonWithoutRollBack(Person person); 


(2) 服务 实现 : 


package com.wisely.ch8 4.service.impl; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Service; 

import 
org.springframework.transaction.annotation.Transactional; 


import com.wisely.ch8 4.dao.PersonRepository; 

import com.wisely.ch8 4.domain.Person; 

import com.wisely.ch8 4.service.DemoService; 

@Service 

public class DemoServicelmpl implements DemoService { 
@Autowired 
PersonRepository personRepository; //1 


@Transactional(rollbackFor= 
{IllegalArgumentException.class}) //2 
public Person savePersonWithRollBack(Person person) { 
Person p -personRepository.save(person); 


if(person.getName().equals("iEz &"))( 
throw new IllegalArgumentException("iEz: KE, 
数据 将 回 深 " );//3 
} 


return p; 


j 


QTransactional(noRollbackFor- 
{IllegalArgumentException.class}) //4 


public Person savePersonWithoutRollBack(Person person) { 
Person p -personRepository.save(person); 


if (person.getName().equals("iEZ &"))[ 
throw new IllegalArgumentException(" 汗 云 飞 虽 已 存 
在 ， 数 据 将 不 会 回 深 "); 
J 


return p; 
} 
} 


代码 解释 
可 以 直接 注入 我 们 的 RersonRepository 的 


Bean ? 


(使 用 @Transactional 注 解 的 rollbackFor 属 
性 ， 指 定 特定 异常 时 ， 数 据 回 深 。 


(3) 便 编码 手动 触发 异 弟 。 


(4) 使 用 @Transactional 注 解 的 noRollbackFor 属 
性 ， 指 定 特定 异常 时 ， 数 据 回 深 


5. f BAN 


package com.wisely.ch8 4.web; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.ch8 4.domain.Person; 
import com.wisely.ch8 4.service.DemoService; 


QRestController 

public class MyController { 
@Autowired 
DemoService demoService; 


QRequestMapping("/rollback") 
public Person rollback(Person person){ //1 


return demoService.savePersonWithRollBack(person); 


j 


QRequestMapping("/norollback") 
public Person noRollback(Person person) {//2 


return 
demoService.savePersonWithoutRollBack(person); 


代码 解释 

中 测试 回 深情 况 。 

@ 测 试 不 回 滚 情况 。 

6. 运 行 

为 了 更 清楚 地 理解 回 演 ， 我 们 以 debug (调试 


模式 ) 启动 程序 。 并 在 DemoServiceImpl 的 
savePersonWithRollBack77 EF EEA, ° 


1) [BR 


访问 http:Wlocalhost: 8080/rollback? name= 汗 
云 飞 &age=32， 调 试 至 savePersonWithRoll]Back 方 
法 ， 如 图 8-50 所 示 。 


import com.wisely.ch8 4.domain.Person; 
import com.wisely.ch8 4.service.DemoService; 
@Service 
public class DemoServiceImpl implements DemoService { 
S @Autowired 
PersonRepository personRepository; //1 


@Transactional(rollbackFor={IllegalArgumentException.class}) //2 
public Person |savePersonWithRollBack[Person person){ 


TEGE 4 © p= Person (id=75) = 

th m address= null E 

n > g age= Integer (id=80) ‘| 
return 4 w id= Long (id=104) 

E : 


B Console X > 


p84Application [Java || 
b15-@7-15 19:00:24 
p15-07-15 19:00:2 


图 8-50 [HIYA 


我 们 可 以 发 现 数 据 已 你 和 存 且 获 得 id 为 27。 继 
续 执 行 抛 出 异 币 ， 将 导致 数据 回 秘 ， 如 图 8-51 所 
VAES [o 


java.lang.IllegalargumentException: $a VETTE: ARKE 
at com.wisely.ch8 4.service.impl.DemoServiceImpl.savePersonWithRollBack(DemoServiceImpl.java:21) 
at sun.reflect.NativeMethodAccessorImpl.invoke@(Native Method) 
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) 
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) 
at java.lang.reflect.Method.invoke(Unknown Source) 
at org.springframework.aop.support.AopUtils.invokeJoinpointUsingReflection(AopUtils.java:302) 
at org.springframework.aop.framework.ReflectiveMethodInvocation.invokeJoinpoint(ReflectiveMethodInvocation.java:190) 
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.]java:157) 
at org.springframework.transaction.interceptor.TransactionInterceptor$1.proceedWithInvocation(TransactionInterceptor.java:S 
at org.springframework. transaction. interceptor. TransactionAspectSupport. invokeWithinTransaction (TransactionAspectSupport. jz 
at org.springframework. transaction. interceptor. TransactionInterceptor. invoke(TransactionInterceptor. java:96) 
at org.springframework.aop. framework. ReflectiveMethodInvocation. proceed(ReflectiveMethodInvocation. java:179) 
at org.springframework.aop. framework. JdkDynamicAopProxy. invoke (JdkDynamicAopProxy . java:287) 
at com. sun. proxy. $Proxy68.savePersonWithRollBack(Unknown Source) 
at com wicely ch? A weh Murnntrn11er ralihack/(muCantcaller java+t2) 


图 8-51 ”数据 回 深 


我 们 查看 数据 库 ， 并 没有 新 增 数 据 ， 如 图 8- 
52 所 示 。 


SQL | Output | Statistics. 


select t.*, t.rowid from PERSON t 


ADDRESS JAGE _ | NAME _|ROWID 
32 Ez: € … AAAE5GAABAAAKhBAAA … 
3l x = AAAESGAABAAAKhBAAB … 
30 yy * AAAESGAABAAAKhBAAC ~- 
29 zz = AAAESGAABAAAKhBAAD … 
28 aa = AAAESGAABAAAKhBAAE … 
27 bb = AAAESGAABAAAKhBAAF ~ 


v boot@XE -J 6 rows selected in 0 


图 8-52 未 新 增 数据 
(2) PENR 


访问 http:Wlocalhost: 8080/norollback? name= 
(ER &&age-32, RATHI Seay, unES- 
53 所 示 。 但 数据 并 没有 回 深 ， 且 数据 库 还 新 增 了 
一 条 记 有 杂 ， 如 图 8-54 所 示 。 


java.lang.Illegalàrgumenttxception: 汪 云 飞 虽 已 存在 ， 数 据 将 不 会 回 滚 


at com.wisely.ch8 4.service.impl.DemoServiceImpl.savePersonWithoutRollBack(DemoServiceImpl.java:31) 

at sun.reflect.NativeMethodAccessorImpl.invoke@(Native Method) 

at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) 

at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) 

at java.lang.reflect.Method.invoke(Unknown Source) 

at org.springframework.aop.support.AopUtils.invokeJoinpointUsingReflection(AopUtils.java:302) 

at org.springframework.aop.framework.ReflectiveMethodInvocation.invokeJoinpoint(ReflectiveMethodInvocation.java:190) 
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:157) 


图 8-53 BANE 


select t.*, t.rowid from PERSON t 


EEE … AAAESGAABAAAKhBAAA ~ 
ax s AAAESGAABAAAKHBAAB 一 
~ AAAESGAABAAAKhBAAD ~- 
IB LARAESGAABARARREAAE TII 


Ka-54 II% T — RAE 


8.5 AIET Cache 


我 们 知道 一 个 程序 的 瓶 令 在 于 数据 库 ， 我 们 
也 知道 内 存 的 速度 是 大 大 快 于 人 硬盘 的 速度 的 。 当 
我 们 需要 重复 地 获取 相同 的 数据 的 时 候 ， 我 们 一 
次 又 一 次 的 请 求 效 据 库 或 着 远程 服务 ， 导 致 大 量 
的 时 间 耗 训 在 数据 库 碍 询 或 者 远程 方法 调用 上 ，， 
导致 程序 性 能 的 恶化 ， 这 便 是 数据 缓存 要 解决 的 


问题 。 
8.5.1 ” Spring 缓存 支持 


Spring 定义 了 
org.Springframework.cache.CacheManager 和 
org.Springframework.cache.Cache 接 口 用 来 统一 不 同 
的 缓存 的 技术 。 其 中 ，CacheManager 征 Spring 拥 供 
的 各 种 缓存 技术 抽象 接口 ，Cache 接 口 包含 缓存 的 
各 种 操作 〈 增 加、 删除 、 获 得 缓存 ， 我 们 一 般 不 
会 直接 和 此 接口 打交道 ) 。 


1.Spring 文 持 的 CacheManager 


针对 不 同 的 缓存 技术 ， 需 要 实现 不 同 的 
CacheManager，Spring 定 义 了 如 表 8-5 所 示 的 
CacheManager 实 现 。 


表 8-5 ”CacheManager 实 现 


CacheManager 描 xk 
SimpleCache Manager 使 用 简单 的 Collection 来 存储 缓存 ， 主 要 用 来 测试 用 途 
ConcurrentMapCacheManager 使 用 ConcurrentMap 来 存储 缓 右 
NoOpCache Manager 仅 测试 用 途 ， 不 会 实际 存储 缓存 
EhCacheCacheManager 使 用 EhCache 作为 缓存 技术 
GuavaCacheManager 使 用 Google Guava 的 GuavaCache 作为 缓存 技术 
HazelcastCacheManager 使 用 Hazelcast 作为 缓存 技术 
JCacheCacheManager x Ji JCache( JSR-107 ) 标 准 的 实现 作为 缓存 技术 , 如 Apache Commons JCS 
RedisCacheManager 使 用 Redis 作为 缓存 技术 


在 我 们 使 用 任意 一 个 实现 的 CacheManager 的 
时 候 ， 需 注册 实现 的 CacheManager 的 Bean， 例 
如 : 


QBean 
public EhCacheCacheManager cacheManager (CacheManager 
ehCacheCacheManager) { 


return new EhCacheCacheManager ( ehcacheCacheManager ) ; 


当然 ， 每 种 缓存 技术 都 有 很 多 的 额外 配置 ， 
但 配置 cacheManager 是 发 不 可 少 的 。 


2. 声 名 式 绥 存 注解 


Spring 提供 了 4 个 注解 来 声明 缓存 规 则 〈 又 是 
使 用 注解 式 的 AOP 的 一 个 生动 例子 ) 。 这 四 个 注 
解 如 表 8-6 所 示 。 


表 8-6 ”声明 式 缓存 注意 


o WM 解 R 
@Cacheable 在 方法 执行 前 Spring 先 查 看 缓存 中 是 否 有 数据 ， 如 果 有 数据 ， 则 直接 返回 缓存 数据 ; 若 没 有 数 
据 ， 调 用 方法 并 将 方法 返回 值 放 进 缓存 
@CachePut ICE 去 的 返回 值 放 到 缓存 中 。@CachePut 的 属性 与 @Cacheable 保持 一 致 
@CacheEvict 将 一 条 FPE 
@Caching 可 以 通过 @Caching 注解 组 合 多 个 注解 策略 在 一 个 方法 上 


@Cacheable、@CachePut、@CacheEvit 都 有 
value 属 性 ， 指 定 的 是 要 使 用 的 缓存 名 称 ; key 属 性 
指定 的 是 数据 在 绥 存 中 的 存储 的 刍 。 


Pe e 


开局 声名 式 绥 存 文 持 十 分 简单 ， 只 需 在 配置 
类 上 使 用 @EnableCaching 注 解 即 可 ， 例 如 : 


QConfiguration 
QEnableCaching 
public class AppConfig { 


j 


8.5.2 Spring Boot 的 文 持 


在 Spring 中 使 用 缓存 技术 的 天 键 是 配置 
CacheManager， 而 Spring Boot 为 我 们 目 动 配置 了 
多 个 CacheManager 的 实现 。 


Spring Boot 的 CacheManager 的 目 动 配置 放置 
在 org.springframework.boot.autoconfigure.cache 包 


中 ， 如 图 8-55 所 示 。 


4 册 cache 


> $a CacheAutoConfiguration.class 


> 4g CacheCondition.class 

> 4g CacheConfigFileCondition.class 

> 4g CacheConfigurations.class 

> $$ CacheProperties.class 

p CacheType.class 

> top EhCacheCacheConfiguration.class 
> 4g GenericCacheConfiguration.class 


. $ù GuavaCacheConfiguration.class 


> 1g HazelcastCacheConfiguration.class 


> InfinispanCacheConfiguration.class 
> 4g JCacheCacheConfiguration.class 


D JCacheManagerCustomizer.class 
> 4g NoOpCacheConfiguration.class 
> 1g RedisCacheConfiguration.class 
> fy SimpleCacheConfiguration.class 


图 8-55 ”CacheManager 的 自动 配置 


通过 图 8-56 我 们 可 以 看 出 ，Spring Boot 为 我 们 
目 动 配置 了 EhCacheCacheConfiguration (使 用 
EhCache) 、GenericCacheConfiguration (使 用 
Collection) 、GuavaCacheConfiguration (使 用 
Guava) 、HazelcastCacheConfiguration (使 用 
Hazelcast) ^ InfinispanCacheConfiguration (使 用 
Infinispan) ^ JCacheCacheConfiguration (使 用 
JCache) ^ NoOpCacheConfiguration (不 使 用 存 
储 ) ^ RedisCacheConfiguration (使 用 Redis) ^ 
SimpleCacheConfiguration (使 用 
ConcurrentMap) 。 在 不 做 任何 额外 配置 的 情况 
下 ， 默 认 使 用 的 是 SimpleCacheConfiguration， 即 
使 用 ConcurrentMapCacheManager。Spring Boot xz 
持 以 “spring.cache” 为 前 组 的 属性 来 配置 绥 存 。 


spring.cache.type- # 可 选 generic, ehcache, hazelcast, 
infinispan, jcache, redis, # guava, simple, none 
spring.cache.cache-names= # 程序 启动 时 创建 缓存 名 称 
spring.cache.ehcache.config- # ehcache 配 置 文件 地 址 
spring.cache.hazelcast.config- # hazelcast 配置 文件 地 址 
spring.cache.infinispan.config- # infinispan 配置 文件 地 址 
spring.cache.jcache.config- # jcache 配置 文件 地 址 
spring.cache.jcache.provider- # 当 多 个 jcache 实 现在 类 路 径 中 的 时 
候 ， 指 定 jcache 实 现 

spring.cache.guava.spec- # guava specs 


在 Spring Boot 环 境 下 ， 使 用 缓存 技术 只 需 在 
项 目 中 导入 相 天 缓存 技术 的 依 顿 包 ， 并 在 配置 关 


使 用 @EnableCaching 开 局 缓存 文 持 即 可 。 
8.5.3 ”实战 


本 例 将 以 Spring Boot 默 认 的 
ConcurrentMapCacheManager 作 为 缓存 技术 ， 演 示 
@Cacheable、@CachePut、@CacheEvit， 最 后 使 
Fi EhCache ` Guava K ER ZEE TXU7N. ° 


1.391 € Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 Cache (spring- 
boot-starter-cache) ^ JPA (spring-boot-starter-data- 
jpa) 和 Web (spring-boot-starter-web) 。 


项 H fiii: 


groupId: com.wisely 
arctifactId:ch8 5 
package: com.wisely.ch8 5 


添加 Oracle JBBCZXz/J, FFE 
a don ， 写 上 例 保持 一 
AW o 


2. 实 体 类 


package com.wisely.ch8 5.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 

public class Person ( 
QId 
QGeneratedValue 
private Long id; 


private String name; 
private Integer age; 


private String address; 


public Person() { 
super(); 


public Person(Long id, String name, Integer age, String 
address) ( 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 
this.address - address; 


// getter ` setter 


3. XR Repository 


package com.wisely.ch8 5.dao; 


import 
org.springframework.data.jpa.repository.JpaRepository; 


import com.wisely.ch8 5.domain.Person; 


public interface PersonRepository extends 
JpaRepository«Person, Long» ( 


4. 业 务 服务 


(1) 接口 : 


package com.wisely.ch8 5.service; 


import com.wisely.ch8 5.domain.Person; 


public interface DemoService ( 
public Person save(Person person); 


public void remove(Long id); 


public Person findOne(Person person); 


(2) 实现 类 . 


package com.wisely.ch8 5.service.impl; 


import 


org.springframework.beans.factory.annotation.Autowired 


import 
import 
import 
import 


import 
import 
import 


org 


com. 
.Wisely.ch8 5.domain.Person; 
.Wisely.ch8 5.service.DemoService; 


com 
com 


QService 
public class DemoServicelmpl implements DemoService { 


.springframework.cache.annotation.CacheEvict 
org. 
org. 
org. 


springframework.cache.annotation.CachePut; 
springframework.cache.annotation.Cacheable; 
springframework.stereotype.Service; 


wisely.ch8 5.dao.PersonRepository; 


, 


, 


QAutowired 
PersonRepository personRepository; 


QOverride 

@CachePut(value = "people", key="#person.id") //1 

public Person save(Person person) { 
Person p = personRepository.save(person); 
System.out.println("7jid ` keyA:"+p.getId()+ "AGENT 2X 


5"); 
return p; 
} 
@Override 


@CacheEvict(value = "peopele") //2 

public void remove(Long id) { 
System.out.println(" 删 除了 id、key 为 "+id+" 的 数据 缓存 ")， 
personRepository.delete(id); 


j 


@Override 

@Cacheable(value="people", key="#person.id") //3 

public Person findOne(Person person) { 
Person p - personRepository.findOne(person.getId()); 
System.out.println("7jid ` key7j:"*p.getId()- Zi T 2X 


f"); 
j 


return p; 


代码 解释 


@@CachePut 绥 和 存 新 增 的 或 更 新 的 数据 到 绥 
其 中 缕 生 名 称 为 people， 数 据 的 key 定 person 
Mid ° 


@O@CacheEvict 从 缓存 people 中 删除 key 为 id 的 
数据 ° 


@ @Cacheable2& ffkey ři personHyidaxqe $2 
4#people# ° 


这 里 特别 说 明 下 ， 如 果 没 有 指定 key， 则 方法 
参数 作为 key 保 存 到 缓存 中 。 


5. f HAN 


package com.wisely.ch8 5.web; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.ch8 5.domain.Person; 
import com.wisely.ch8 5.service.DemoService; 


QRestController 
public class CacheController { 


@Autowired 
DemoService demoService; 


QRequestMapping("/put") 
public Person put(Person person)( 
return demoService.save(person); 


QRequestMapping("/able") 
public Person cacheable(Person person)( 


return demoService.findOne(person); 


j 


QRequestMapping("/evit") 

public String evit(Long id){ 
demoService.remove(id); 
return "ok"; 


6. 开 局 缓存 文 持 


package com.wisely.ch8 5; 

import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplication 
import org.springframework.cache.annotation.EnableCaching; 
QSpringBootApplication 

QEnableCaching 

public class Ch85Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch85Application.class, args); 


Jj 


代码 解释 


在 Spring Boot 中 还 是 要 使 用 @EnableCaching 
JF BERE CBE ° 


Po 


当 我 们 对 数据 做 了 缓存 之 后 ， 数 据 的 获得 将 
从 缓存 中 得 到 ， 而 不 是 从 数据 中 得 到 。 当 前 的 
数据 库 的 数据 情况 如 图 8-56 所 示 。 


Output | : Statistics. 


select t.*, t.rowid from PERSON t 


E- e SEES €@658 6 


ID ADDRESS [AGE [NAME _|ROWID 
JEZ Ķ AAAESGAABAAAKhBAAA … 
^ AAAESGAABAAAKhBAAB … 
^ AAAESGAABAAAKhBAAC … 
^ AAAESGAABAAAKhBAAD … 
^ AAAESGAABAAAKhBAAE ~ 
^ AAAESGAABAAAKhBAAF ~~ 


v boot@XE d 6 rows selected in 0.015 


图 8-56 ”当前 数据 库 的 数据 情况 


我 们 在 每 次 运行 测 翅 情况 下 ， 都 重 局 了 应 用 
程序 。 


(1) 测试 @Cacheable 


一 次 访 癌 http:/localhost: 8080/able? 
id-1, 第 一 次 将 调用 方法 理 询 数据 库 ， 并 将 数据 
放 到 缓存 people 中 。 


此 时 控制 台 输 出 如 下 : 


2015-07-17 13:26:38.543 INFO 2696 --- [ 

2015-07-17 13:29:22.979 INFO 2696 --- [nio-8080 
2015-07-17 13:29:22.979 INFO 2696 --- [nio-8080 
2015-07-17 13:29:23.007 INFO 2696 --- [nio-8080 


Hibernate: select personO .id as idl 0 0 , perso 
为 id key?9: IRIT EE 


页 面 输出 如 图 8-57 所 示 。 


ESI 
@ localhost:8080/able?id- x ee — 
e C | D localhost:8080/able?id=1 WE 


图 8-57 页 面 输出 结果 


再 次 访 [9http://localhost: 8080/able? id=1, 
此 时 控制 台 没 有 再 次 输出 Hibernate 的 查询 语句 ， 
以 及 “为 d、keywei 1 数据 做 了 缓存 ”字样 ， 表 示 


没有 调用 这 个 方法 ， 页 面 直接 从 数据 缓存 中 获得 
数据 。 
页 面 输 出 结果 如 图 8-58 所 示 。 


.0 B= 
@ localhost:8080/able?id- x = 


| € œŒ |[5localhost:8080/able?id-1 S 三 


i 


图 8-58 ”页 面 输出 结果 
(2) 测试 @CachePut 


访问 http:/localhost: 8080/put? 
name=cc&age=22&address= 成 都 ， 此 时 控制 台 输 出 
如 下 : 


Hibernate: select hibernate sequence.nextval from dual 
Hibernate: insert into person (address, age, name, id) values (?, ?, ?, ?) 


为 id、key 为 ;62 数据 做 了 缀 存 


页 面 输出 如 图 8-59 所 示 。 


=>». 7 = | |=) Sm 


@ localhost:8080/put?nan x V o» a 
<< C | [5localhost:8080/put?name-cc&: 7? | = 
i 

“da = 82, 

"name" : "cc 

"age" : 22, 

address" : “成 都 


Kj8-59 测试 @CachePnut 


我 们 再 次 访 问 http:/localhost: 8080/able? 
id=62， 控 制 台 无 输出 ， 从 缓存 二 接 狄 得 数据 ， 页 
面 显示 如 图 8-59 所 示 。 


(3) 测试 @CacheEvit 
访问 http:/localhost: 8080/able? id=1， 为 id 为 
1 的 数据 做 缓存 ， 册 次 访问 http:/localhost; 
8080/able? id=1， 确 认 数 据 已 从 缓存 中 获取 。 


访问 http://localhost: 8080/evit? id=1， 从 缓存 
中 删除 key 为 1 的 缓存 数据 ; 


2015-07-17 14:38:40.847 INFO 3360 --- [nio-8080-exec-1] o.s.web.serv 
Hibernate: select personO .id a as| i id1 8 8 , person@_.address as addres 


为 id 、key 为 :1 数据 做 了 绥 
人 id、key 为 1 的 数据 缓存 | 


再 次 访 [9http://localhost: 8080/able? id=1, 
见 察 控制 台 重 新 做 了 绥 存 : 


Hibernate: select person@_.id as idl 8 0 , person@ 
为 1d、key 为 :1 数据 做 了 绎 存 
HIRE 7 id. keyA BSR 
Hibernate: select pe 

3T iy t 区 


t person9 .id as id1 0 0 , per 


页 面 显 示 如 图 8-58 所 示 。 
8.5.4 WRIA 


切换 缓存 技术 除了 移入 相关 依赖 包 或 者 配置 
以 外 ， 使 用 方式 和 实战 例子 保持 一 致 。 下 面 简要 
讲解 在 Spring EhCache 和 Guava 作 为 缓存 
拉 术 的 方式 ， 其 余 缓存 技术 也 是 类 似 的 方式 。 


1.EhCache 


当 我 们 需要 使 用 EhCache 作 为 缓存 技术 的 时 
E 我 们 只 需 在 pom.xml 中 添加 EhCache 的 依赖 即 
可 : 


<dependency> 
«groupId»net.sf.ehcache«/groupId» 
<artifactId>ehcache</artifactId> 
</dependency> 


EhCache 所 需 的 配置 文件 ehcache.xml 只 需 放 在 
类 路 径 下 ，Spring Boot 会 目 动 扫 描 ， 例 如 ; 


<?xml version="1.0" encoding="UTF-8"?> 
<ehcache> 

«cache name="people" maxElementsInMemory="1000" /> 
</ehcache> 


Spring Boot 会 给 我 们 目 动 配置 
EhCacheCacheManagerf'JBean ° 


2.Guava 


当 我 们 需要 使 用 Guava 作 为 缓存 技术 的 时 候 ， 
我 们 也 只 需 在 pom.xml 中 增加 Guava 的 依赖 即 可 : 


<dependency> 
<groupId>com.google.guava</groupId> 
<artifactId>guava</artifactId> 
<version>18 .0</version> 
</dependency> 


Spring Boot 会 给 我 们 目 动 配置 


GuavaCacheManager 这 个 Bean。 


3.Redis 


使 用 Redis， 只 需 汪 加 下 面 的 依赖 即 可 : 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
redis</artifactId> 
</dependency> 


Spring Boot 将 会 为 我 们 目 动 配置 
RedisCacheManager 以 及 RedisTemplate 上 的 Bean ° 


8.6 ” 非 天 系 型 数据 库 NoSQL 


NoSQL 是 对 于 不 使 用 关系 作为 数据 管理 的 数 
据 库 系统 的 统称 。NoSQL 的 主要 特点 是 不 使 用 
SQL 语言 作为 查询 语言 ， 数 据 存储 也 不 是 固定 的 
表 、 字 段 。 

NoSQL 数 据 库 主 要 有 文档 存储 型 


(MongoDB) 、 图 形 关 系 存储 型 (Neo4j) 和 键 值 
对 存储 型 (Redis) 。 


本 万 将 闭 示 基于 MongoDB 的 数据 访问 以 及 基 
于 Redis 的 数据 访问 。 


8.6.1 MongoDB 


MongoDB 是 一 个 基于 文档 (Document) 的 存 
储 型 的 数据 库 ， 使 用 面向 对 象 的 思想 ， 每 一 条 数 
据 记 录 都 是 文档 的 对 象 。 


在 本 万 我 们 不 会 介绍 太 多 关于 MongoDB 数 据 
库 本 喘 的 知识 ， 本 区 主 要 讲述 Spring 及 Spring Boot 


对 MongoDB 的 文 持 ， 以 及 基于 Spring Boot 和 
MongoDB 的 实战 例子 。 


1.Spring 的 文 持 
Spring*^j MongoDBB] x: f$ 3: 2 iH Spring 
Data MongoDB 来 实现 的 ，Spring Data MongoDB 
为 我 们 提供 了 如 下 功能 。 
(1) Object/Document 映 射 注解 支持 
JPA 提 供 了 一 套 Object/Relation 映 射 的 注解 


(@Entity ` @Id) ， 而 Spring Data MongoDB 也 提 
供 了 和 8-7 所 示 的 注解 。 


#28-7 JEP 
= 解 d xh 
Q Document 有 映射 领域 对 象 与 MongoDB 的 一 个 文档 
@ld 映射 当前 属性 是 ID 
@DbRef 当前 属性 将 参考 其 他 的 文档 
@Field 为 文档 的 属性 定义 名 称 
@Version 将 当前 属性 作为 版 本 


(2) MongoTemplate 


像 JdbcTemplate 一 样 ，Spring Data MongoDB 
也 为 我 们 提供 了 一 个 MongoTemplate， 
MongoTemplate 为 我 们 提供 了 数据 访问 的 方法 。 我 


们 还 需要 为 MongoClient 以 及 MongoDbFactory 来 配 
置 数据 库 连 接 属 性 ， 例 如 : 


QBean 
public MongoClient client() throws UnknownHostException 


MongoClient client - new MongoClient(new 
ServerAddress("127.0.0.1", 27017)); 
return client; 


} 


QBean 
public MongoDbFactory mongoDbFactory() throws Exception 


{ 

String database = new 
MongoClientURI("mongodb://localhost/test").getDatabase(); 
return new SimpleMongoDbFactory(client() , 

database); 


j 


QBean 
public MongoTemplate mongoTemplate(MongoDbFactory 
mongoDbFactory) throws UnknownHostException { 
return new MongoTemplate(mongoDbFactory); 


} 
(3) Repository A’) x s 


类 似 于 Spring Data JPA, Spring Data 
MongoDB fælt T Repository] xF, EHD AA 
Spring Data JPA 一 致 ， 定 义 如 下 : 


public interface PersonRepository extends 
MongoRepository«Person, String» { 


类 似 于 Spring Data JPA 的 开启 支持 方式 ， 
MongoDB 的 Repository 的 文 持 开 启 需 在 配置 类 上 注 
解 @EnableMongoRepositories， 例 如 : 


QConfiguration 
QEnableMongoRepositories 
public class AppConfig { 


} 
2.Spring Booth x $i 


Spring Boot 对 MongoDB 的 文 择 ， 分 别 位 于 : 


org.springframework.boot.autoconfigure.mongo 


+ BACB AOR EYES ` MongoTemplate ° (I | 
可 以 使 用 以 “spring.data.mongodb” 为 前 级 的 属性 来 
配置 MongoDB 相 天 的 信息 。Spring Boot 为 我 们 提 
供 了 一 些 默 认 必 性， 如 默认 MongoDB 的 端口 为 
27017、 默 认 服务 器 为 localhost、 默 认 数 据 库 为 
test ° Spring Boot 有 的 主要 配置 如 下 : 


spring.data.mongodb.host- # 数据 库 主 机 地 址 ， 默 认 localhost 
spring.data.mongodb.port-27017 # 数据 库 连 接 端 口 默认 27107 
spring.data.mongodb.uri=mongodb://localhost/test # 
connection URL 

spring.data.mongodb.database- 


spring.data.mongodb.authentication-database- 
spring.data.mongodb.grid-fs-database- 
spring.data.mongodb.username- 

spring.data.mongodb.password- 
spring.data.mongodb.repositories.enabled-true #repository zt? 
是 否 开 启 ， 默 认为 已 开 
spring.data.mongodb.field-naming-strategy- 
org.springframework.boot.autoconfigure.data.mongo 


为 我 们 开局 了 对 Repository 的 文 持 ， 即 目 动 为 
我 们 配置 了 @EnableMongoRepositories ° 


所 以 我 们 在 Spring Boot 下 使 用 MongoDB 只 需 
5| Aspring-boot-starter-data-mongodb A BARI Ay, JE 
须 任 何 配置 。 


3. 实 战 


ult 


(1) 安装 MongoDB 


1) 非 Docker 安 效 。 若 不 使 用 Docker 作 为 安装 
HX, IET DL 
https://www.mongodb. org/downloads?f. P $838 合 目 
己 当 前 操作 系统 的 版 本 来 安装 MongoDB 。 


2) Docker 安 装 。 前 面 已 经 下 载 好 了 MongoDB 
的 Docker 镜 像 ， 接 下 来 需 通过 下 面 命 令 运行 
Docker% #8: 


docker run -d -p 27017:27017 mongo 


运行 好 以 后 ， W4 E VirtualBox 44 DO L1 
ESF, anEjg-eoBTZR ° 


127.0.0.1 


127.0.0.1 


127.0.0.1 


127.0.0.1 


图 8-60 “端口 映射 


MongoDB 效 据 库 管理 软件 可 使 用 
Robomongo， 下 载 地 址 是 
http://www.robomongo.org， 如 图 8-61 所 示 。 


.&' Robomongo 0.8.5 
| File View Options Window Help 


"EFI*IDIC 
4 (8 localhost (2) 

> 点 System 

> E3 test 


图 8-61 Robomongo 弄 面 
(2) 搭建 Spring Boot 项 目 


搭建 Spring Boot 项 目 ， 依 赖 为 MongoDB 
(spring-boot-starter-data-mongodb) 和 Web 
(spring-boot-starter-web) 。 


项 H 信息 : 


groupId: com.wisely 
arctifactId:ch8 6 1 
package: com.wisely. ch8 6 1 


因为 Spring Boot 的 默认 数据 库 连 接 满 足 我 们 
当前 测试 的 要 求 ， 所 以 将 不 在 为 


application.properties 配 置 连接 信息 。 
(3) 领域 模型 


AR AES — (Person) ， 包 含 他 工作 

过 的 地 点 (Location) 。 这 个 虽然 和 关系 型 数据 库 

的 一 对 多 类 似 ， 但 还 T 样 的 Location 的 数据 
只 属于 某 个 人 。 


Person} fi: 


package com.wisely.ch8 6 1.domain; 


import java.util.Collection; 
import java.util.LinkedHashSet; 


import org.springframework.data.annotation.Id; 
import 
org.springframework.data.mongodb.core.mapping.Document; 


@Document //1 
public class Person ( 

QId //2 

private String id; 

private String name; 

private Integer age; 

QField("locs")//3 

private Collection<Location> locations = new 
LinkedHashSet<Location>(); 


public Person(String name, Integer age) { 
super (); 
this.name = name; 
this.age = age; 


} 
// 省 略 getter、setter 方 法 


代码 解释 


中 @Document 注 解 映射 领域 模型 和 MongoDB 
的 文档 。 


@@Id 注 解 表 明 这 个 属性 为 文档 的 Id 。 


@Q@rField 注 解 此 属性 在 文档 中 的 名 称 为 locs， 
locations 属 性 将 以 数组 形式 存在 当前 数据 记 承 中 。 


Location 源 位 : 


package com.wisely.ch8 6 1.domain; 
public class Location ( 
private String place; 


private String year; 

public Location(String place, String year) ( 
super(); 
this.place - place; 
this.year - year; 


} 
H 


// 省 


getter、setter 方 法 


(4) 数据 访问 : 


package com.wisely.ch8 6 1.dao; 
import java.util.List; 


import 


org.springframework.data.mongodb.repository.MongoRepository; 
import org.springframework.data.mongodb.repository.Query; 


import com.wisely.ch8 6 1.domain.Person; 


public interface PersonRepository extends 
MongoRepository«Person, String» { 


Person findByName(String name); //1 


@Query("{'age': ?0}") //2 
List<Person> withQueryFindByAge(Integer age); 


代码 解释 
OLF IEZ AW o 


G 文 持 @Query 碍 询 ， 碍 询 参数 构造 JSON 字 人 符 
RB RT ° 


(5) FERJAN: 


package com.wisely.ch8 6 1.web; 


import java.util.Collection; 

import java.util.LinkedHashSet; 

import java.util.List; 

import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 
import com.wisely.ch8 6 1.dao.PersonRepository; 

import com.wisely.ch8 6 1.domain.Location; 

import com.wisely.ch8 6 1.domain.Person; 


QRestController 
public class DataController { 


@Autowired 
PersonRepository personRepository; 


@RequestMapping("/save") //1 

public Person save(){ 
Person p = new Person("wyf",32); 
Collection<Location> locations = new 

LinkedHashSet«Location»(); 

Location loci = new Location(" Lif", "2009"); 
Location loc2 = new Location(" 合 肥 ", "2010"); 
Location loc3 = new Location(" 广 州 ", "2011"); 
Location loc4 = new Location(" 马 鞍山 "，"20127" ) ; 
locations.add(loci); 
locations.add(loc2); 
locations.add(loc3); 
locations.add(loc4); 
p.setLocations(locations); 
return personRepository.save(p); 


j 


@RequestMapping("/qi") //2 
public Person qi(String name) { 
return personRepository.findByName(name); 


j 


QRequestMapping("/q2") //3 
public List<Person> q2(Integer age){ 
return personRepository.withQueryFindByAge(age); 


j 
代码 解释 
中 测试 保存 数据 。 
DWAT EZ AW o 


(3) 测 试 @Query 查 询 。 
(6) 运行 
测试 你 存 数 据 
访问 http://localhost: 8080/save 测 斌 保存， 页 
面 如 图 8-62 所 示 。 
| 
| 


/ @ localhost:8080/save x ¥ 


—Á 


Es C | D localhost:8080/save 


l'id':"55ab3cc49e006c33fabb5dffa", "name" :" wyf", age" :32, "locat 
ions“ :[l'place":" E38", "year" :" 2009"], l'place":"& 

BD", "year" :"2010"], l'Dlace" :" M^, "year" :" 20117], 

{"place”:“ 马 鞍山 ", "year": "2012" 1]] 


图 8-62 ”测试 保存 


我 们 可 以 在 Robomongo 中 查看 保存 后 的 数 
据 ， 如 图 8-63 所 示 。 


Value 
£3 (1) Objectld(" 'e00 d ( 5 fields ) 
m id Objectid("S5ab c33fab5dffa") 
=") class com.wisely. in.Pers. 
2 nam wyf 
age 32 
4 (£3 locs Array [4] 
4 &3 ( 2 field 
= place 上 海 
2009 
&»1 ( 2 fiel 
"" place 合肥 
2010 
4 &32 (2 fields ) 
= place 广州 
2011 
E=] ( 2 fiel 
=" place E 
2012 


图 8-63 ”查看 保存 后 的 数据 
测试 方法 名 查询 


访问 http:Wlocalhost: 8080/q1? name=wyf， 页 
面 结果 如 图 8-64 所 示 。 


illi Query & 18] 


访问 http:Wlocalhost: 8080/q2? age=32， 页 面 
结果 如 图 8-65 所 示 。 


g localhost:8080/g1?nam. x VW — * -一 
€ > QC |[localhost8080/q1?2name-wyf y? = 


l'id':"55ab3ccd9e006c33fab5dffa", "name" :“wyt", “ age" :32, "locat 
ions" :[l'place":" L5", "year" :"2009"], l'place^:"& 

* "year": "2010" ], {place” :" 广州 ", "year" :" 20117], 
l'place": "BRU", "year" : "2012"1]] 


图 8-64 测试 方法 名 查询 


| @ localhost:8080/q2?age= x V — | 
€ > C D localhost:8080/q2?age=32 WwW 
[{" id": “SSab3ce49e006c33£ abSdff a" , " name" : “wyf", "age" : 32, " loca 


tions": [["place":" E38", " year": "2009" ], place“: 
BB", "year": "2010" ), {“ place" :" AH", "year" :" 20117], 


place": " SSRUI", "year" :"2012"1]1] 


图 8-65 ”测试 @Query 查 询 


0.6.2 Redis 


Redis 是 一 个 基于 键 值 对 的 开源 内 存 数据 存 
储 ， 当 然 Redis 也 可 以 做 数据 缓存 〈( 见 8.5.4 节 ) 。 


1.Spring 的 文 持 
(1) 配置 


Spring 对 Redis 时 文 持 也 是 通过 Spring Data 
Redis 来 实现 的 ，Spring Data JPA 为 我 们 提供 了 连 
接 相 天 的 ConnectionFactory 和 数据 操作 相关 的 
RedisTemplate。 在 此 特别 指出 ，Spring Data Redis 
只 对 Redis 2.6 和 2.8 版 本 做 过 测试 。 


根据 Redis 的 不 同 的 Java 窜 己 问 ，Spring Data 
Redis 提 供 了 如 下 的 ConnectionFactory: 


JedisConnectionFactory: 使 用 Jedis 作 为 Redis 
BE Pm ° 

JredisConnectionFactory: 使 用 Jredis 作 为 Redis 
BE Pm o 

LettuceConnectionFactory: 使 用 Lettuce 作 为 
Redis% F “i ° 


SrpConnectionFactory: 使 用 Spullara/redis- 
protocol 作 为 Redis 客 户 端 。 


EJAT: 


QBean 
public RedisConnectionFactory redisConnectionFactory() { 
return new JedisConnectionFactory(); 


RedisTemplate 配 置 方式 如 下 : 


QBean 
public RedisTemplate<Object, Object» 
redisTemplate()throws UnknownHostException { 
RedisTemplate«Object, Object» template = new 
RedisTemplate«Object, Object>(); 


template.setConnectionFactory(redisConnectionFactory()); 
return template; 


j 


(2) 使 用 


Spring Data Redis 为 我 们 提供 了 RedisTemplate 
和 StringRedisTemplate 两 个 模板 来 进行 数据 操作 ， 
其 中 ，StringRedisTemplate 只 针对 键 值 都 是 字符 型 
的 数据 进行 操作 。 


RedisTemplate 和 StringRedisTemplate 提 供 的 主 
要 数据 访问 方法 如 表 8-8 所 示 。 


表 8-8 数据 访问 方法 


更 多 关于 Spring Data Redis 的 控 作 ， 请 查看 
Spring Data Redis 官 方 文 档 。 


(3) 定义 Serializer 


当 我 们 的 数据 存储 到 Redis 的 时 候 ， 我 们 的 键 
(key) 和 值 (value) 都 是 通过 Spring 提 供 的 
Serializer 序 列 化 到 数据 库 的 。RedisTemplate 默 认 
使 用 的 是 JdkSerializationRedisSerializer， 
StringRedisTemplate 默 认 使 用 的 是 
StringRedisSerializer ° 


Spring Data JPA 为 我 们 提供 了 下 面 的 


Serializer: 


GenericToStringSerializer ^ 
Jackson2JsonRedisSerializer ^ 
JacksonJsonRedisSerializer ^ 
JdkSerializationRedisSerializer ` OxmSerializer ^ 
StringRedisSerializer ° 


2.Spring Boot 的 文 持 


Spring Boot 对 Redis 的 文 持 ， 
org.Springframework.boot.autoconfigure.redis 包 如 


8-66 所 示 。 


4 出 redis 
tib RedisAutoConfiguration.class 


| Tip RedisProperties.class 


[8-66 Redis®, 


RedisAutoConfiguration 为 我 们 默认 配置 了 
JedisConnectionFactory、RedisTemplate 以 及 
StringRedisTemplate， 让 我 们 可 以 直接 使 用 Redis 作 


为 数据 存储 。 


RedisProperties 回 我 们 展示 了 可 以 使 用 
以 “spring.redis” 为 前 级 的 属性 在 
application.properties 中 配置 Redis， 主 要 属性 如 
下 : 


spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 


database- 0# 数据 库 名 称 ， 默 认为 dbg 
host-localhost # 服 务 嚣 地址， 默认 为 1ocalhostt 
password- # 数据 库 密码 d 

port=6379 4 连接 端口 号 ， 默 认为 6379 
pool.max-idle-8 4 连接 池 设 置 
pool.min-idle-0 

pool.max-active-8 

pool.max-wait--1 

sentinel.master- 


spring.redis.sentinel.nodes- 
spring.redis.timeout- 


3. 实 战 
(1) 安装 Redis 


1) 非 Docker 安 装 。 知 不 基于 Docker 安 装 的 
话 ， 我 们 可 以 到 http://redis.io/download 下 载 合适 版 
本 的 Redis。 注 意 不 要 下 载 最 新 版 本 的 3.0.x 和 版 本 。 


2) Docker 安 装 o 表面 我 们 已 经 下 载 好 了 Redis 
人 镜像， 通过 下 面 命令 运行 容 兹 : 


docker run -d -p 6379:6379 redis:2.8.21 


“并 在 VirtualBox 配 置 端口 映射 ， 如 图 8-67 所 
ZJN œ 
(Prosesu w 


名 称 协议 主机 IP sun o ” 子 系统 IP — FAS Q 
|mongo TCP 127.0.0.1 27017 27017 


| oracle TCP 127.0.0.1 1521 1521 
| ssh TCP 127.0.0.1 2022 22 


webui TCP 127.0.0.1 9090 
IE TCP 127.0.0.1 6379 ra 


( we )]| ma 


图 8-67 ”端口 映射 


Redis 效 据 管理 可 以 使 用 Redis Client， 下 载 地 
tit Ahttps://github.com/caoxinyu/RedisClient, i 
一 个 可 以 独立 运行 的 jar 包 ， 如 图 8-68 所 示 。 


Fa 
= al 
@ RedisClient aa 


Server Data View Tools Favorites Help 


[e o [5 localhost: 
4 E Redis servers = | se Redis data explorer 
4 


= 
a 
o 
m 
e 


18-68 RedisClient 
(2) 新 建 Spring Boot 项 目 
搭建 Spring Boot 项 目 ， 依 赖 为 Redis (spring- 


boot-starter-redis) 和 Web (spring-boot-starter- 
web) 。 


项 H 信息 : 


groupId: com.wisely 
arctifactId:ch8 6 2 
package: com.wisely. ch8 6 2 


7 F Spring Boot 的 于 认 数 据 库 连 接 满 足 我 们 
当 前 测试 的 要 求 ， 所 以 无 须 不 在 
application.properties 配 置 连接 信息 。 


(3) 领域 模型 类 


package com.wisely.ch8 6 2.dao; 

import java.io.Serializable; 

public class Person implements Serializable( 
private static final long serialVersionUID - 1L; 


private String id; 
private String name; 
private Integer age; 


public Person() { 
super(); 


public Person(String id,String name, Integer age) ( 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 


j 
E 


/省 


/ getter ` setter Ñ IË 
} 


代码 解释 


此 类 必须 用 时 间 序 列 化 接口 ， 因 为 使 用 
Jackson 做 序列 化 需要 一 个 空 构 造 。 


(4) 数据 访问 : 
package com.wisely.ch8 6 2.domain; 


import javax.annotation.Resource; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.data.redis.core.RedisTemplate; 
import 
org.springframework.data.redis.core.StringRedisTemplate; 
import org.springframework.data.redis.core.ValueOperations; 
import org.springframework.stereotype.Repository; 


import com.wisely.ch8 6 2.dao.Person; 


QRepository 
public class PersonDao { 


@Autowired 
StringRedisTemplate stringRedisTemplate; //1 


@Resource(name="stringRedisTemplate" ) 
ValueOperations<String, String> valOpsStr; //3 


@Autowired 
RedisTemplate<Object, Object> redisTemplate; //2 


@Resource(name="redisTemplate" ) 
ValueOperations<Object, Object> valOps; //4 


public void stringRedisTemplateDemo(){ //5 
valOpsStr.set("xx", "yy"); 
j 


public void save(Person person)( 
valOps.set(person.getlId(),person); //6 
} 


public String getString(){ 
return valOpsStr.get("xx");//7 


public Person getPerson(){ 
return (Person) valOps.get("1");//8 


代码 解释 


@Spring Boot 已 为 我 们 配置 
StringRedisTIemplate， 在 此 处 可 以 直接 注入 。 


@Spring Boot 已 为 我 们 配置 RedisTemplate， 
在 此 处 可 以 直接 注入 。 


(3) 可 以 使 用 @Resource 注 解 指定 
stringRedisTemplate， 可 注入 基于 字符 串 的 简单 属 
性 操作 方法 。 

(4) 可 以 使 用 @Resource 注 解 指 定 
redisTemplate， 可 注入 基于 对 象 的 简单 属性 操作 方 
ix; 

(XB set iA, TET PRISE 

(6) 通 过 set 方 法 ， 人 存储 对 象 类 型 。 


(DO 通过 get 方 法 ， 获 得 字符 串 。 


@@ 通 过 get 方 法 ， 获 得 对 象 。 
(5) 配置 


Spring Boot 为 我 们 目 动 配置 了 
RedisTemplate， 而 RedisTemplate 使 用 的 是 
JdkSerializationRedisSerializer， 这 个 对 我 们 演示 
Redis Client 很 不 直观 ， 因 为 
JdkSerializationRedisSerializer 使 用 二 级 制 形 式 存 储 
数据 ， 在 此 我 们 将 目 己 配置 RedisTemplate 并 定义 


Serializer ? 


package com.wisely.ch8 6 2; 

import java.net.UnknownHostException; 

import org.springframework.boot.SpringApplication; 
import 


org.springframework.boot.autoconfigure.SpringBootApplication 


4 
import org.springframework.context.annotation. Bean; 


import 
org.springframework.data.redis.connection.RedisConnectionFac 
tory; 

import org.springframework.data.redis.core.RedisTemplate; 
import 


org.springframework.data.redis.serializer.Jackson2JsonRedisS 
erializer; 

import 
org.springframework.data.redis.serializer.StringRedisSeriali 
zer; 


import com.fasterxml.jackson.annotation.JsonAutoDetect; 
import com.fasterxml.jackson.annotation.PropertyAccessor; 
import com.fasterxml.jackson.databind.ObjectMapper; 


QSpringBootApplication 


public class Ch862Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch862Application.class, args); 
} 


QBean 
@SuppressWarnings({ "rawtypes", "unchecked" }) 
public RedisTemplate<Object, Object> 
redisTemplate(RedisConnectionFactory redisConnectionFactory) 
throws UnknownHostException { 
RedisTemplate«Object, Object» template = new 
RedisTemplate<Object, Object>(); 


template.setConnectionFactory(redisConnectionFactory); 


Jackson2JsonRedisSerializer 
jackson2JsonRedisSerializer - new 
Jackson2JsonRedisSerializer(Object.class); 

ObjectMapper om = new ObjectMapper(); 

om.setVisibility(PropertyAccessor.ALL, 
JsonAutoDetect.Visibility.ANY); 


om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON FINAL) 


了 


jackson2JsonRedisSerializer.setObjectMapper(0om); 


template.setValueSerializer(jackson2JsonRedisSerializer); 
//1 

template.setKeySerializer(new 
StringRedisSerializer()); //2 


template.afterPropertiesSet(); 
return template; 


代码 解释 


OE (value) 的 序列 化 采用 


Jackson2JsonRedisSerializer ? 


ORE (key) 的 序列 化 采用 


StringRedisSerializer ° 


(6) 控制 器 : 


package com.wisely.ch8 6 2.web; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.ch8 6 2.dao.Person; 
import com.wisely.ch8 6 2.domain.PersonDao; 


QRestController 
public class DataController { 


@Autowired 
PersonDao personDao; 


@RequestMapping("/set") //1 

public void set(){ 
Person person = new Person("1","wyf", 32); 
personDao.save(person); 
personDao.stringRedisTemplateDemo(); 


j 


@RequestMapping("/getStr") //2 
public String getStr(){ 
return personDao.getString(); 


j 


QRequestMapping("/getPerson") //3 
public Person getPerson(){ 


return personDao.getPerson( ); 


代码 解释 
QO 演示 设置 字符 及 对 象 。 
演示 获得 字符 。 
@) 演 示 获 得 对 象 。 
(7) 运行 


演示 设置 字符 及 对 象 ， 访 问 http:/localhost: 
8080/set， 此 时 查看 Redis Client ° 


字符 存储 如 图 8-69 所 示 。 


String |TTL 


Server localhost 


Key xx 


Value 


图 8-69 字符 存储 


对 象 存 储 如 图 8-70 所 示 。 


Name Type Size 

emi String 1 

ER String 1 

L- Imp I 

String | TTL 
Serve localhost Database 
Key 1 
Val ['com.wi ely.ch8_6_2.dao.Person”{"id":"1", "name"s"wyf”,"age":32)]| | 


图 8-70 RATE 


演示 获得 字符 ， 访 问 http:Wlocalhost: 
8080/getStr， 页 面 显 示 如 图 8-71 所 示 。 


| @ localhost:8080/getStr 


和 一 


yy 


H ^r 


图 8-71 ”获得 字符 


演示 获得 对 象 ， 访 问 http://localhost: 
8080/getPerson， 页 面 显 示 如 图 8-72 所 示 。 


@ localhost:8080/getPersc x V — 


€ > QC D localhost:8080/getPerson 


l'id':"1","name":"wyf", “age”: 32} 


图 8-72 ”获得 对 象 
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9.1 安全 控制 Spring Security 
9.1.1 Spring Security 快 速 入 门 


1. 什 么 是 Spring Security 


Spring Security 征 专门 针对 基于 Spring 的 项 目 
的 安全 框架 ， 元 分 利用 了 依赖 注入 和 AOP 来 实现 
安全 的 功能 。 


在 早期 的 Spring Security 版 本 ， 使 用 Spring 
Security 需 要 使 用 大 量 的 XML 配置 ， 而 本 和 将 全 部 
基于 Java 配 置 来 实现 Spring Security 的 功能 。 


安全 框架 有 两 个 重要 的 概念 ， 即 认证 
(Authentication) 和 授权 (Authorization) 。 认 证 
即 确认 用 户 可 以 访问 当前 系统 ; 授权 即 确定 用 户 
在 当前 系统 下 所 拥有 的 功能 权限 ， 本 廊 将 围绕 认 
证 和 授权 展开 。 


2.Spring Security 的 配置 
(1) DelegatingFilterProxy 


Spring Security) Full sett T — 1 T XX leas 
来 实现 所 有 安全 的 功能 ， 我 们 只 需 注册 一 个 特殊 
的 DelegatingFilterProxy 过 滤 硕 到 
WebApplicationInitializerB] J ° 


而 在 实际 使 用 中 ， 我 们 只 需 让 目 己 的 
Initializer 类 继承 AbstractSecurity 
WebApplicationInitializer 抽 和 象 类 即 可 。 
AbstractSecurityWebApplicationInitializer 实 现 了 
WebApplicationInitializer 接 口 ， 并 通过 onStartup 方 
法 调用 : 


insertSpringSecurityFilterChain(servletContext); 


它 为 我 们 注册 了 DelegatingFilterProxy 。 
insertSpringSecurityFilterChaini/& £3 4I F : 


private void 

insertSpringSecurityFilterChain(ServletContext 
servletContext) { 

String filterName = DEFAULT FILTER NAME; 

DelegatingFilterProxy springSecurityFilterChain - 
new DelegatingFilterProxy( 

filterName); 

String contextAttribute - 
getWebApplicationContextAttribute(); 

if (contextAttribute !- null) ( 


springSecurityFilterChain.setContextAttribute(contextAttribu 
te); 


registerFilter(servletContext, true, filterName, 
springSecurityFilterChain); 


所 以 我 们 只 需 用 以 下 代码 即 可 开局 Spring 
Security: 18 as LIT: 


public class AppInitializer extends 
AbstractSecurityWebApplicationInitializer{ 


} 


(2) 配置 


Spring Security 的 配置 和 Spring MVC 的 配置 类 
似 ， 只 需 在 一 个 配置 类 上 注解 
(@EnableWebSecurity， 并 让 这 个 类 继承 
WebSecurityConfigurerAdapter 即 可 。 我 们 可 以 通 
过 重 写 configure 方 法 来 配置 相关 的 安全 配置 。 


代码 如 下 : 


QConfiguration 

QEnablewebSecurity 

public class WebSecurityConfig extends 
WebSecurityConfigurerAdapter( 


QOverride 
protected void configure(HttpSecurity http) throws 
Exception ( 


super.configure(http); 


QOverride 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
super.configure(auth); 


QOverride 
public void configure(WebSecurity web) throws Exception 
{ 
super .configure(web) ; 
} 


3. 用 户 认证 
认证 需要 我 们 有 一 套用 户 数 据 的 来 源 ， 而 授 
权 则 是 对 于 某 个 用 己 有 相应 的 角色 权限 。 在 Spring 
Security 里 我 们 通过 重 写 
方法 来 实现 定制 。 
(1) 内 存 中 的 用 户 


使 用 AuthenticationManagerBuilderb 的 
inMemoryAuthentication 方 法 即 可 添加 在 内 存 中 的 
用 户 ， 并 可 给 用 户 指定 角色 权限 


QOverride 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
auth.inMemoryAuthentication() 


.WithUser("wyf").password("wyf").roles("ROLE ADMIN") 
.and() 


.WithUser("wisely").password("wisely").roles("ROLE USER"); 
} 


(2) JDBC 中 的 用 户 
JDBC 中 的 用 户 直 接 指定 dataSource 即 可 。 


@Autowired 
DataSource dataSource; 


QOverride 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
auth.jdbcAuthentication().dataSource(dataSource); 


不 过 这 看 上 去 很 奇 尾 ， 其 实 这 里 的 Spring 
Security 是 默认 了 你 的 数据 库 结构 的 。 通 过 
jdbcAuthenticationB 2/85, BA Der HE 
JdbcDaoImpl 中 定义 了 默认 的 用 户 及 角色 权限 获取 
的 SQL 语句 : 


public static final String DEF USERS BY USERNAME QUERY = 
"select username,password,enabled " 
+ "from users " + "where username = ?"; 
public static final String 
DEF AUTHORITIES BY USERNAME QUERY - "select 


username, authority " 
+ "from authorities " + "where username = ?"; 


当然 我 们 可 以 目 定 义 我 们 的 查询 用 户 和 权限 
的 SQL 语句 ， 例 如 ; 


QOverride 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
auth.jdbcAuthentication().dataSource(dataSource) 
.usersByUsernameQuery(" select 
username,password,true " 
* "from myusers where username - ?") 
.authoritiesByUsernameQuery("select 
username,role " 


} 
(3) 通用 的 用 户 


上 面 的 两 种 用 户 和 权限 的 获取 方式 只 限于 内 
存 或 者 JDBC， 我 们 的 数据 访问 方式 可 以 是 多 种 各 
样 的 ， 可 以 是 非 关 系 型 数据 库 ， 也 可 以 是 我 们 第 
用 的 JPA 等 。 


这 时 我 们 需要 自 定义 实现 UserDetailsService 接 
患 。 上 上面 的 内 存 中 用 户 及 JDBC 用 户 束 是 
UserDetailsService 的 实现 ， 定 义 如 下 : 


+ "from roles where username = ?"); 


public class CustomUserService implements UserDetailsService 


@Autowired 
SysUserRepository userRepository; 


QOverride 
public UserDetails loadUserByUsername(String username) 
throws UsernameNotFoundException ( 


SysUser user - 
userRepository.findByUsername(username); 

List«GrantedAuthority» authorities -new 
ArrayList«GrantedAuthority»(); 

authorities.add(new 
SimpleGrantedAuthority("ROLE ADMIN")); 

return new 
User(user.getUsername(),user.getPassword(), authorities); 


I 


WHH: SysUser 古 我 们 系统 的 用 户 领 域 对 象 
类 ，User 来 日 于 


org.springframework.security.core.userdetails.User ° 


除 此 之 外 ， 我 们 还 需要 注册 这 个 
CustomUserService， 代 码 如 下 : 


QBean 

UserDetailsService customUserService(){ 
return new CustomUserService(); 

} 


@Override 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
auth.userDetailsService(customUserService()); 


4. 请 求 授 权 


Spring Security zE3B BS 
protected void configure(HttpSecurity http) 
方法 来 实现 请 求 拦截 的 。 
Spring Security 使 用 以 下 匹配 絮 来 匹配 请 求 路 


Tt: 


e antMatchers: 使 用 Ant 风 格 的 路 径 死 配 。 
e regexMatchers: 使 用 正则 表达 式 匹 配 路 径 。 


anyRequest: 匹配 所 有 请 求 路 径 。 

在 匹配 了 请 求 路 径 后 ， 需 要 针对 当前 用 户 的 
BORAT KER TT ZEAN, Spring Securityte 
供 了 表 9-1 所 示 的 安全 处 理 方法 。 


表 9-1 安全 处 理 方法 


5 法 用 途 
access(String) Spring EL 表达 式 结 果 为 true 时 可 访问 
anonymous() 匿名 可 访问 
denyAll() 用 户 不 能 访问 
fullyAuthenticated() H 人 证 可 访问 ( 非 b FE ) 
hasAnyAuthority(String...) 如 果 用 月 有 参数 ， 则 其 中 任 一 权限 可 访问 
hasAnyRole(String...) 如 果 用 户 有 参数 ， 则 其 中 任 一 角色 可 访问 
hasAuthority(String) 如 果 用 户 有 参数 ， 则 其 权限 可 访问 
hasIpAddress(String) 如 果 用 户 来 自 参 数 中 的 了 正则 可 访问 
hasRole(String) 若 用 户 有 参数 中 的 角色 可 访问 
permitAll() 用 户 可 任意 访问 
rememberMe() 允许 通过 remember-me 登录 的 用 户 访问 
authenticated() 用 户 登 录 后 可 访问 


我 们 可 以 看 一 下 下 面 的 示例 代码 : 


QOverride 
protected void configure(HttpSecurity http) throws 
Exception { 
http 
.authorizeRequests() //1 
.antMatchers("/admin/**").hasRole("ROLE ADMIN") //2 


.antMatchers("/user/**").hasAnyRole("ROLE ADMIN","ROLE USER" 
] LLB 
.anyRequest( ).authenticated();//4 


代码 解释 


(通过 authorizeRequests 方 法 来 开始 请 求 权 限 
配置 。 


请求 匹 配 /admin/**， 只 有 拥有 
ROLE_ADMIN 和 角色 的 用 户 可 以 访问 。 


(3) 请 求 匹配 /user/**， 拥 有 ROLE_ADMIN 或 
ROLE_USER 角 色 的 用 户 都 可 访问 。 


出 其 余 所 有 的 请 求 都 需要 认证 后 (登录 后 ) 
才 可 访问 。 


5. 定 制 登录 行为 
我 们 也 可 以 通过 重 写 


protected void configure(HttpSecurity http ) 
方法 来 定制 我 们 的 登录 行为 。 


面 将 重用 的 登录 行为 的 定制 以 体 短 的 代码 
BUR: 


QOverride 
protected void configure(HttpSecurity http) throws 
Exception ( 
http 
.formLogin() //1 
.loginPage("/login") //2 
.defaultSuccessUrl("/index") //3 
.failureUrl("/login?error") //A 
.permitAll() 
.and() 
.rememberMe() //5 
.tokenValiditySeconds(1209600) //6 
.key("myKey") //7 
.and() 
. logout( )//8 
.logoutUrl("/custom-logout") //9 
.logoutSuccessUrl("/logout-success") //10 
.permitAll(); 


} 
代码 解释 
通过 formLogin 方 法 定制 登 孙 操作 。 


2) 使 用 loginPage 方 法 定制 登录 页 面 的 访问 地 
Hl o 


GdefaultSuccessUrl38 XE SR EV] Je; ££ [R] HP] Dd. 
面 o 


@failureUrl 指 定 登 杂 失 败 后 转 同 的 页 面 。 
@rememberMe 开 局 cookie 存 储 用 户 信 息 。 


@tokenValiditySeconds 指 定 cookie 有 将 期 为 
1209600 秒 ， 即 2 个 星期 。 


@key 指 定 cookie 中 的 私 钥 。 

(8) 使 用 logout 方 法 定制 注销 行为 。 

@logoutUrl 指 定 注销 的 URL 路 人 径 。 
@logoutSuccessUrl 指 定 注 销 成 功 后 转 疝 的 页 


9.1.2 Spring Boot 的 文 持 


Spring Boot 针 对 Spring Security 的 目 动 配置 在 
org.springframework.boot.autoconfigure.security £J 


H o 


主要 通过 SecurityAutoConfiguration 和 
SecurityProperties 来 完成 配置 。 


SecurityAutoConfiguration= A J 
SpringBootWebSecurityConfiguration 中 的 配置 。 在 
SpringBootWebSecurityConfiguration 配 置 中 ， 我 们 
获得 如 下 的 目 动 配置 : 


1) 自动 配置 了 一 个 内 存 中 的 用 户 ， 账 号 为 
user， 和 密码 在 程序 局 动 时 出 现 。 


2) 忽略 /css/**、/js/**、/images/** 
和 /#*#/favicon.ico 等 静态 文件 的 拦 规 。 


3) 自动 配置 的 securityFilterChainRegistration 
的 Bean。 


SecurityProperties 使 用 以 “security” 为 前 级 的 属 
性 配置 Spring Security 相 关 的 配置 ， 包 含 : 


security.user.name-user # 内 存 中 的 用 户 默认 账号 为 user 
security.user.password- # 1 默认 用 户 的 密码 
security.user.role-USER # 默认 用 户 的 角色 
security.require-ssl-false # 是 否 需要 ssl 支 持 
security.enable-csrf-false # 是 否 开启 “ 跨 站 请 求 伪 造 " 支 持 ， 默 认 关 闭 
security.basic.enabled-true 
security.basic.realm-Spring 

security.basic.path- # /** 
security.basic.authorize-mode- 
security.filter-order=0 
security.headers.xss=false 
security.headers.cache=false 


security.headers.frame-false 
security.headers.content-type-false 
security.headers.hsts-all 
security.sessions-stateless 
security.ignored- # 用 过 号 隔 开 的 无 须 拦 截 的 路 径 


Spring Boot 为 我 们 做 了 如 此 多 的 配置 ， 当 我 
们 需要 目 己 扩展 的 配置 时 ， 只 需 配 置 类 继承 
WebSecurityConfigurerAdapter 关 即 可 ， 无 须 使 用 
@EnablewebSecurity 注 解 ， 例 如 : 


QConfiguration 
public class WebSecurityConfig extends 
WebSecurityConfigurerAdapter { 


j 


9.1.3 ”实战 


在 本 区 的 示例 中 ， 我 们 将 演示 使 用 Spring 
Boot 下 的 Spring Security JG E. E BY fa] FATALE 
授权 的 功能 。 此 区 我 们 将 通过 Spring Data JPA 获 得 
用 户 数据 。 页 面 模板 使 用 Thymeleaf ，Thymeleaf 也 
为 我 们 提供 了 文 持 Spring Security 的 标签 。 


1.391 && Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA (spring- 
boot-starter-data-jpa) 、Security (spring-boot- 


starter-security) ^ Thymeleaf (spring-boot-starter- 
thymeleaf) ° 


项 H 信息 : 


groupId: com.wisely 
arctifactId:ch9 1 
package: com.wisely. ch9 1 


JF Sl OracleZX2/J K Thymeleafh Spring 
Security 的 文 持 。 


<dependency> 
«groupId»com.oracle«c/groupId» 
<artifactId>ojdbc6</artifactId> 
<version>11.2.0.2.0</version> 
</dependency> 


<dependency> 
«groupId»org.thymeleaf.extras«/groupId» 
«artifactiId-thymeleaf-extras- 
springsecurity4</artifactId> 
</dependency> 


我 们 的 application.properties 配 置 旭 下 : 


spring.datasource.driverClassName-oracle.jdbc.OracleDriver 
spring.datasource.url=jdbc\:oracle\:thin\:@localhost\:1521\: 
xe 

spring.datasource.username=boot 
spring.datasource.password=boot 


logging. level.org.springframework.security= INFO 


spring.thymeleaf .cache=false 


spring.jpa.hibernate.ddl-auto-update 
spring.jpa.show-sql-true 


将 bootstrap.min.css 放 置 在 
src/main/resources/static/css 下 ， 此 路 径 默认 不 拦 


E © 


2. 用 户 和 角色 
我 们 使 用 JPA 来 定义 用 户 和 角色 。 


HP 


package com.wisely.ch9 1.domain; 


import java.util.ArrayList; 
import java.util.Collection; 
import java.util.List; 


import javax. 
import javax. 
import javax. 
import javax. 
import javax. 
import javax. 


persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 


CascadeType; 
Entity; 
FetchType; 
GeneratedValue; 
Id; 

ManyToMany; 


import org.springframework.security.core.GrantedAuthority; 


import 


org.springframework.security.core.authority.SimpleGrantedAut 


hority; 
import 


org.springframework.security.core.userdetails.UserDetails; 


QEntity 


public class SysUser implements UserDetails{//1 


private static final long serialVersionUID - 1L; 


QId 


QGeneratedValue 


private Long id; 

private String username; 

private String password; 

@ManyToMany(cascade = {CascadeType.REFRESH}, fetch = 
FetchType.EAGER) //2 

private List<SysRole> roles; 


QOverride 
public Collection<? extends GrantedAuthority> 
getAuthorities() (//3 
List«GrantedAuthority» auths - new 
ArrayList«GrantedAuthority»(); 
List«SysRole» roles-this.getRoles(); 
for(SysRole role:roles){ 
auths.add(new 
SimpleGrantedAuthority(role.getName())); 
} 


return auths; 


QOverride 
public boolean isAccountNonExpired() { 
return true; 


QOverride 
public boolean isAccountNonLocked() ( 
return true; 


QOverride 

public boolean isCredentialsNonExpired() ( 
return true; 

} 

QOverride 

public boolean isEnabled() { 
return true; 


// 省 略 getter、setter 方 法 


代码 解释 


(DD 让 我 们 的 用 尸 实体 实现 UserDetails 授 口 ， 我 
们 的 用 户 实体 即 为 Spring Security 所 使 用 的 用 户 。 


GO 配置 用 户 和 角色 的 多 对 多 关系。 


(9) 重 写 getAuthorities 方 法 ， 将 用 户 的 角色 作为 
XBR ° 


角色 : 


package com.wisely.ch9 1.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 

public class SysRole ( 
QId 
QGeneratedValue 
private Long id; 
private String name; //1 
// 省 略 getter、setter 方 法 


代码 解释 
Dname 为 角色 名 称 。 

(1) 数据 结构 及 初始 化 
” 当 我 们 配置 用 户 和 角色 的 多 对 多 关系 后 ， 通 


过 设置 


spring.jpa.hibernate.ddl-auto=update 


为 我 们 目 动 生成 用 户 表 : SYS_USER、 角 色 
X: SYS ROLE ` KIAK: SYS_USER_ROLES ° 


针对 上 面 的 表 结 构 ， 我 们 初始 化 一 些 数 据 来 
方便 我 们 演示 。 在 Srwmain/resources 下 ， 新 建 
data.sq]|， 即 新 建 两 个 用 户 ， 角 色 分 别 为 
ROLE ADMIN 和 ROLE_ USER， 代 码 如 下 : 


insert into SYS USER (id,username, password) values 
(1,'wyf', 'wyf'); 

insert into SYS USER (id,username, password) values 
(2,'wisely', 'wisely'); 


insert into SYS ROLE(id,name) values(1, 'ROLE_ADMIN'); 
insert into SYS ROLE(id,name) values(2, ROLE USER'); 


insert into SYS USER ROLES(SYS USER ID,ROLES ID) 
values(1,1); 
insert into SYS USER ROLES(SYS USER ID,ROLES ID) 
values(2,2); 


(2) 传 值 对 象 
用 来 测试 不 同 角色 用 户 的 数据 展示 : 


package com.wisely.ch9 1.domain; 


public class Msg { 
private String title; 
private String content; 
private String etraInfo; 
public Msg(String title, String content, String 
etraInfo) { 
super(); 


this.title = title; 
this.content - content; 
this.etraInfo - etraInfo; 


} 
// 省 略 getter、setter 方 法 


3. 效 据 访 问 
我 们 这 里 的 数据 访问 很 简单 ， 代 码 如 下 : 


package com.wisely.ch9 1.dao; 


import 
org.springframework.data.jpa.repository.JpaRepository; 


import com.wisely.ch9 1.domain.SysUser; 


public interface SysUserRepository extends 
JpaRepository<SysUser, Long>{ 


SysUser findByUsername(String username); 


代码 解释 
这 里 只 需 一 个 根据 用 户 名 碍 出 用 户 的 方法 。 
4. 目 定义 UserDetailsService 


package com.wisely.ch9 1.security; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.security.core.userdetails.UserDetails; 


import 
org.springframework.security.core.userdetails.UserDetailsSer 
vice; 

import 
org.springframework.security.core.userdetails.UsernameNotFou 
ndException; 


import com.wisely.ch9 1.dao.SysUserRepository; 
import com.wisely.ch9 1.domain.SysUser; 


public class CustomUserService implements UserDetailsService 
{ //1 

@Autowired 

SysUserRepository userRepository; 


QOverride 
public UserDetails loadUserByUsername(String username) { 
7/2 


SysUser user = 
userRepository.findByUsername(username); 
if(user == null)( 
throw new UsernameNotFoundException("HF 4A 
&"); 
} 


return user; //3 


代码 解释 
CD) Axe SEH UserDetailsServiced O ° 
(Co) 重 写 loadUserByUsername 方 法 获得 用 户 。 


9) 我 们 当前 的 用 户 实现 了 UserDetails 接 口 ， 可 
直接 返回 给 Spring Security 使 用 。 


5.B B 


(1) Spring MVCACE: 


package com.wisely.ch9 1.config; 


import org.springframework.context.annotation.Configuration; 
import 
org.springframework.web.servlet.config.annotation.ViewContro 
llerRegistry; 

import 
org.springframework.web.servlet.config.annotation.WebMvcConf 
igurerAdapter; 


QConfiguration 
public class WebMvcConfig extends WebMvcConfigurerAdapter{ 


@Override 
public void addViewControllers(ViewControllerRegistry 
registry) { 


registry.addViewController("/login").setViewName("login"); 


j 


代码 解释 
注册 访问 /login 转 同 login.html 页 和 面 。 
(2) Spring Security 配 置 : 
package com.wisely.ch9 1.config; 
import org.springframework.context.annotation.Bean; 


import org.springframework.context.annotation.Configuration; 
import 


org.springframework.security.config.annotation.authenticatio 
n.builders.AuthenticationManagerBuilder; 

import 
org.springframework.security.config.annotation.web.builders. 
HttpSecurity; 

import 
org.springframework.security.config.annotation.web.configura 
tion.WebSecurityConfigurerAdapter; 

import 
org.springframework.security.core.userdetails.UserDetailsSer 
vice; 

import com.wisely.ch9 1.security.CustomUserService; 


@Configuration 
public class WebSecurityConfig extends 
WebSecurityConfigurerAdapter{//1 


@Bean 

UserDetailsService customUserService(){ //2 
return new CustomUserService(); 

} 


QOverride 
protected void configure(AuthenticationManagerBuilder 
auth) throws Exception { 
auth.userDetailsService(customUserService()); //3 


J 


QOverride 
protected void configure(HttpSecurity http) throws 
Exception { 
http.authorizeRequests() 
.anyRequest().authenticated() //4 
.and( ) 
.formLogin() 
. loginPage("/login") 
.failureUrl("/login?error") 
.permitAll() //5 
.and() 
.logout().permitAll(); //6 


代码 解释 


QU 扩展 Spring Security 配 置 需 继承 
WebSecurityConfigurerAdapter ° 


注册 CustomUserService 的 Bean 。 

(3) 添 加 我 们 自 定义 的 user detail service 认 证 。 
所 有 请 求 需 要 认证 即 登录 后 才能 访问 。 

( 引 定 制 登录 行为 ， 登 录 页 面 可 任意 访问 。 
(定制 注销 行为 ， 注 销 请 求 可 任意 访问 。 


<1DOCTYPE html» 
«html xmins:th="http://www.thymeleaf.org"> 
<head> 
<meta content="text/html;charset=UTF-8"/> 
<title> 登 录 页 面 </title> 
<link rel="stylesheet" th:href="@{css/bootstap.min.css}"/> 
«style type="text/css"> 
body { 
padding-top: 50px; 


.starter-template { 
padding: 40px 15px; 
text-align: center; 


j 


</style> 
</head> 
<body> 
«nav class="navbar navbar-inverse navbar -fixed-top"> 
«div class="container'"> 
«div class="navbar -header'"> 
<a class="navbar-brand" href="#">Spring Securityi& 


7R</a> 
</div> 
<div id="navbar" class="collapse navbar-collapse"> 
«ul class="nav navbar -nav'"> 
<li><a th:href="@{/}"> 首页 «/a»«/li» 


</ul> 
«/div»«!--/.nav 


-collapse --> 
«/div» 
</nav> 
<div class="container"> 


<div class="starter-template"> 
<p th:if="${param.logout}" class="bg-warning"> 已 成 功 
注销 </p><!-- 1 --> 
«p th:if="${param.error}" class="bg-danger'"> 有 错误 ， 请 
重 试 </p> <!-- 2 --> 
<h2> 使 用 账号 密码 登录 </h2> 
«form name="form" th:action="@{/login}" 
action="/login" method="POST"> <!-- 3 --> 
<div class="form-group"> 
«label for="username"> 账 号 </Labe1> 
«input type="text" class="form-control" 
name="username" value="" placeholder=" 账 号 " /> 
</div> 
<div class="form-group"> 
«label for="password"> 密 码 </Labe1> 
<input type="password" class="form- 
control" name="password" placeholder="#f5" /> 
</div> 
«input type="submit" id="login" 
value="Login" class="btn btn-primary" /> 
</form> 
</div> 
</div> 


«/body» 
</html> 


代码 解释 
(注销 成 功 后 显示 。 
GO 登录 有 销 误 时 显示 。 
认 的 登录 路 径 为 /login ° 
(2) 首页; 


<!DOCTYPE html» 
«html xmins:th="http://www.thymeleaf.org" 
xmlns:sec-'http://www.thymeleaf.org/thymeleaf-extras- 


springsecurity4"><!-- 1 --> 

<head> 

<meta content="text/htm1; charset=UTF-8"/> 

<title sec:authentication="name"></title> <!-- 2 --> 


<link rel="stylesheet" th:href="@{css/bootstrap.min.css}" /> 
<style type="text/css"> 
body { 
padding-top: 50px; 
} 


.Starter-template { 
padding: 40px 15px; 
text-align: center; 


} 
</style> 
</head> 
<body> 

<nav class="navbar navbar-inverse navbar-fixed-top"> 

<div class="container"> 

<div class="navbar-header"> 
«a class="navbar-brand" href="#">Spring Securityi& 


示 </a> 
</div> 


«div id="navbar" class="collapse navbar-collapse"> 
<ul class="nav navbar -nav"> 
<li><a th:href="@{/}"> 首页 «/a»«/li» 


</ul> 
</div><!--/.nav 


-collapse --> 
</div> 
</nav> 


<div class="container"> 


<div class="starter-template"> 
«hi th: text="${msg.title}"></h1> 


«p class="bg-primary" th:text="${msg.content}"></p> 


<div sec:authorize="hasRole('ROLE_ADMIN')"> <!-- 3 - 


-> 
«p class="bg-info" th:text="${msg.etraInfo}"> 
</p> 
</div> 
<div sec:authorize="hasRole('ROLE_USER')"> <!-- 4--> 
<p class="bg-info"> 无 更 多 信息 显示 </p> 
</div> 
«form th:action="@{/logout}" method="post"> 
<input type="Submit" class="btn btn-primary" 
value="}##H"/><!-- 5 --> 
</form> 
</div> 
</div> 
</body> 
</html> 


代码 解释 


@Thymeleaf 为 我 们 提供 的 Spring Security 有 的 标 
ar CPI e 


(2) 通 过 sec: authentication="name" 获 得 当前 用 


户 的 用 户 名 。 


@sec: authorize="hasRole 
(ROLE_ADMIN') "意味 着 只 有 当前 用 户 觉得 为 
ROLE_ADMIN 时 ， 才 可 显示 标签 内 内 容 。 


@sec: authorize="hasRole 
(ROLE_USER') "意味 着 只 有 当前 用 户 觉 得 为 
ROLE USER 时 ， 才 可 显示 标签 内 内 容 。 


G@) 注 销 的 默认 路 径 为 /logout， 需 通过 POST 请 
求 提交 o 


7. Tl a 
ERARE, HOME WIES RS: 


package com.wisely.ch9 1.web; 


import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 

import 
org.springframework.web.bind.annotation.RequestMapping; 


import com.wisely.ch9 1.domain.Msg; 


@Controller 
public class HomeController { 


QRequestMapping("/") 
public String index(Model model) { 
Msg msg = new Msg(" 测 试 标题 ", "测试 内 容 ", "额外 信息 ， 只 对 


管理 员 显 示 


model.addAttribute("msg", msg); 
return "home"; 
} 
Wes ace 
9.121T 


(1) 登录 。 访 问 http://localhost: 8080， 将 会 
目 动 转 到 登录 页 面 http://localhost: 8080/login, 4H 
图 9-1 所 示 。 


密码 
| toon | 
| | 
图 9-1 转 到 登录 页 面 http://localhost: 8080/login 


使 用 正确 的 账号 密码 登录 ， 如 图 9-2 所 示 。 


c localhost:808( ^»| = 


测试 标题 
IRAS 


额外 信息 ， 只 对 管理 员 显 示 


图 9-2 使 用 正确 的 账号 密码 登录 
使 用 错误 的 账号 密码 登录 ， 如 图 9-3 所 示 。 


全 个 有 大 国 *—— —— -— z I. — 
€ © localhost: } f v 一 


NET 
使 用 账号 密码 登录 


KS 


ve 


图 9-3 ”使 用 错误 的 账号 密码 登录 


(2) 注销 。 登 孙 成 功 后 ， 单 击 注销 按钮 ， 如 
图 9-4 所 示 。 


gi wf 29h — 
a QC | D localhost8080 $e =| 


测 


额外 信息 ， 只 对 管理 员 吕 示 


注销 


图 9-4 单 击 注销 按钮 
此 时 页 面 显 示 如 图 9-5 所 示 。 


ETa Lc c e 
garra x V su. 
€ c localhost.808 t 9 = 
Panic | 
, ir L «er til v 
使 用 账号 密码 登录 
a 
wyf 
E: 2] 


Alo-5 单 击 注销 按钮 
(3 ) 用 户 信息 JO 


页 面 上 我 们 将 用 户 名 显示 在 页 面 的 标题 上 ， 
如 图 9-6 所 示 。 


yj ro H 

测试 标题 
测试 内 容 

额外 信息 ， 只 对 管理 员 显 示 


注销 


图 9-6 ”用户 信息 
(4) 视图 控制 


wyf 和 wisely 用 户 角 色 不 同 ， 因 此 获得 不 同 的 
ALL e 


wyf 用 户 视 图 如 图 9-7 所 示 。 


€ C | [5 localhost:8080 reg =" 


测试 标题 


测试 内 容 


| 额外 信息 ， 只 对 管理 员 显示 | 


注销 


图 9-7 wyf 用 户 视 图 
wisely 用 户 视 图 如 图 9-8 所 示 。 


wisely X V 


œŒ | D localhost:8080 


测试 标题 
测试 内 容 


无 更 多 信息 显示 


注销 


图 9-8 wisely H P XE] 


9.2” 批 处 理 Spring Batch 


9.2.1 Spring Batch 快 速 入 | 


1. 什 么 是 Spring Batch 

Spring Batch 是 用 来 处 理 大 量 数据 操作 的 一 个 
框 染 ， 主 要 用 来 读 取 大 量 数据 ， 然 后 进行 一 是 处 
理 后 输出 成 指定 的 形式 。 

2.Spring Batch 主 要 组 成 


SpringBatch 主 要 由 以 下 几 部 分 组 成 ， 如 表 9-2 
所 示 。 


表 9-2 ”SpringBatch 组 成 部 分 


名 PW 用 R 
JobRepository HIRE Job 的 容器 
JobLauncher 有 来 启动 Job 的 接口 
Job 我 们 要 实际 执行 的 任务 ， 包 含 一 个 或 多 个 Step 
Step Step- 步 又 包含 IemReader ItemProcessor 和 ItemWrter 
ItemReader 昌 来 读 取 数据 的 接口 
ItemProcessor 用 来 处 理 数据 的 接口 
TtemW 昌 来 输出 数据 的 接口 


以 上 Spring Batch 的 主要 组 成 部 分 只 需 注 册 成 
Spring 的 Bean 妈 可。 者 想 开 局 批 处 理 的 文 持 还 需 在 
配置 类 上 使 用 @EnableBatchProcessing ° 


一 个 示意 的 Spring Batch 的 配置 如 下 : 


QConfiguration 
QEnableBatchProcessing 
public class BatchConfig { 


QBean 
public JobRepository jobRepository(DataSource 
dataSource, PlatformTransactionManager transactionManager ) 
throws Exception { 
JobRepositoryFactoryBean jobRepositoryFactoryBean - 
new JobRepositoryFactoryBean(); 
jobRepositoryFactoryBean.setDataSource(dataSource); 


jobRepositoryFactoryBean.setTransactionManager(transactionMa 
nager); 
jobRepositoryFactoryBean.setDatabaseType("oracle"); 
return jobRepositoryFactoryBean.getObject(); 
} 


QBean 
public SimpleJobLauncher jobLauncher(DataSource 
dataSource, PlatformTransactionManager transactionManager ) 
throws Exception { 
SimpleJobLauncher jobLauncher = new 
SimpleJobLauncher(); 


jobLauncher.setJobRepository(jobRepository(dataSource, 
transactionManager)); 
return jobLauncher; 


J 


QBean 
public Job importJob(JobBuilderFactory jobs, Step s1) { 
return jobs.get("importJob") 
.incrementer(new RunIdIncrementer()) 
.flow(s1) 


.end() 
-build(); 


} 


@Bean 
public Step stepi(StepBuilderFactory stepBuilderFactory, 
ItemReader<Person> reader, ItemWriter«Person» writer, 
ItemProcessor<Person,Person> processor) { 
return stepBuilderFactory 
.get("stepi") 
.«Person, Person»chunk(65000) 
. reader (reader) 
. processor(processor ) 
.writer(writer ) 
.build(); 


j 


QBean 

public ItemReader<Person> reader() throws Exception { 
// 新 建 ITtemReader 接 口 的 实现 类 返回 
return reader; 


ini 


j 


QBean 

public ItemProcessor<Person, Person» processor() { 
// 新 建 ITtemProcessor 接 口 的 实现 类 返回 
return processor; 


H 


j 


QBean 
public Itemwriter«Person» writer(DataSource dataSource) 


H 


// 新 建 ITtemWriter 接 口 的 实现 类 返回 
return writer; 


3 Jobs IT 


知 需 要 监听 我 们 的 Job 的 执行 情况 ， 则 定义 个 
一 个 类 实现 JobExecutionListener， 并 在 定义 Job 的 
Bean LZ XE i Us Tz o 


监听 大 的 定义 如 下 : 


public class MyJobListener implements JobExecutionListener( 


QOverride 

public void beforeJob(JobExecution jobExecution) { 
//Job 开 始 前 

} 


QOverride 

public void afterJob(JobExecution jobExecution) { 
//Job 完 成 后 

} 


注册 并 绑 定 监听 硕 到 Job: 


QBean 
public Job importJob(JobBuilderFactory jobs, Step s1) { 
return jobs.get("importJob") 
.incrementer(new RunIdIncrementer()) 


.flow(s1) 
.end() 
.listener(csvJobListener()) 
.build(); 

} 

QBean 


public MyJobListener myJobListener() ( 
return new MyJobListener(); 
} 


4. 数 据 读 取 


Spring Batch 为 我 们 提供 了 大 量 的 ItemReader 
的 实现 ， 用 来 读 取 不同 的 数据 来 源 ， 如 图 9-9 所 
RES 


5. 数 据 处 理 及 校 验 


数据 处 理 和 校 验 都 要 通过 ItemProcessor 接 口 实 
现 来 完成 。 
(1) 数据 处 理 
数据 处 理 只 需 实现 ItemProcessor 接 口 ， 重 写 其 


process 方 法 。 方 法 输入 的 参数 是 从 ItemReader 谈 取 
到 的 数据 ， 返 回 的 数据 给 ItkemwWriter ° 


AmapltemReader<T> - org.springframework.batch.item.amqp 
ItemReaderAdapter«T» - org.springframework.batch.jsr.item 
ItemReaderAdapter«T» - org.springframework.batch.item.adapter 
IteratoritemReader«T» - org.springframework.batch.item.support 
JmsltemReader«T» - org.springframework.batch.item.jms 
ListitemReader«T» - org.springframework.batch.item.support 
ItemStreamReader<T> - org.springframework.batch.item 
4 Q^ AbstractitemStreamitemReader«T» - org.springframework.batch.item.support 
4 (Q^ AbstractitemCountingltemStreamltemReader«T» - org.springframework.batch.item.support 
4 (Q^ AbstractCursoritemReader«T» - org-springframeworkbatch.item.database 
© JdbcCursorltemReader«T» - org.springframework.batch.item.database 
© StoredProcedureltemReader«T» - org.springframework.batch.item.database 
4 Q^ AbstractPaginatedDataltemReader«T» - org.springframework.batch.item.data 
© MongoltemReader«T» - org.springframework.batch.item.deta 
©  Neo4jitemReader«T» - org.springframework.batch.item.data 
4 (Q^ AbstractPagingltemReader«T» - org.springframework.batch.item.database 
© HibernatePagingltemReader<T> - org.springframework.batch.item.database 
© IbatisPagingltemReader«T» - org.springframework.batch.item.database 
© JdbcPagingltemReader<T> - org.springframework.batch.item.database 
© JpaPagingltemReader<T> - org.springframework.batch.item.database 
FlatFileltemReader<T> - org.springframework.batch.item.file 
HibernateCursorltemReader<T> - org.springframework.batch.item.database 
LdifReader - org.springframework.batch.item.ldif 
MappingldifReader«T» - org.springframework.batch.item.Idif 
RepositoryltemReader<T> - org.springframework.batch.item.data 
StaxEventitemReader<T> - org.springframework.batch.item.xml 
© MultiResourceltemReader<T> - org.springframework.batch.item.file 
© ResourcesitemReader - org.springframework.batch.item.file 
© SingleltemPeekableltemReader<T> - org.springframework.batch.item.support 
© SynchronizeditemStreamReader<T> - org.springframework.batch.item.support 
a Q ResourceAwareltemReaderltemStream<T> - org.springframework.batch.item.file 
© FlatFileltemReader«T» - org.springframework.batch.item.file 
© LdifReader - ora.springframework.batch.item.Idif 
©  MappingldifReader«T» - org.springframework.batch.item.ldif 
© StaxEventltemReader«T» - org.springframework.batch.item.xml 
4 Q PeekableltemReader<T> - org.springframework.batch.item 
© SingleltemPeekableltemReader«T» - org.springframework.batch.item.support 


| Press 'Ctri«T to see the supertype hierarchy; 


图 9-9 大 量 ItemReader 实 现 


public class MyItemProcessor implements 
ItemProcessor«Person, Person» ( 


QOverride 
public Person process(Person person) { 
String name = person.getName( ).toUpperCase( ); 


person.setName(name); 
return person; 


(2) 数据 校 验 


我 们 可 以 JSR-303 (主要 实现 有 hibernate- 
validator) 的 注解 ， 来 校 验 ItemReader 读 取 到 的 数 
据 是 否 满 足 要 求 。 


我 们 可 以 让 我 们 的 ItemProcessor 实 现 
ValidatingItemProcessor 接 口 : 


public class MyItemProcessor extends 
ValidatingItemProcessor<Person>{ 


@Override 
public Person process(Person item) throws 
ValidationException { 
super .process(item); 
return item; 
} 
} 


XE FTA Baas, SCHHEÉSValidatorfz Fk Ej 
T spring, ii KAE FHJSR-30385J Validator?E | 
人 


F: 


public class MyBeanValidator<T> implements 
Validator<T>, InitializingBean { 
private javax.validation.Validator validator; 
QOverride 


public void afterPropertiesSet() throws Exception { 
ValidatorFactory validatorFactory - 
Validation.buildDefaultValidatorFactory(); 
validator - 
validatorFactory.usingContext().getValidator(); 
} 
QOverride 
public void validate(T value) throws ValidationException 
t 
Set<ConstraintViolation<T>> constraintViolations = 
validator.validate(value) ; 
if(constraintViolations.size()>0){ 


StringBuilder message = new StringBuilder(); 
for (ConstraintViolation<T> constraintViolation 
: constraintViolations) { 


message.append(constraintViolation.getMessage() + "\n"); 


throw new 
ValidationException(message.toString()); 
} 
} 


在 定义 我 们 的 MyItemProcessor 时 必须 将 
MyBeanValidator 设 置 进 去 ， 代 人 码 如 下 : 


QBean 

public ItemProcessor«Person, Person» processor() { 
MyItemProcessor processor - new MyItemProcessor(); 
processor.setValidator(myBeanValidator()); 
return processor; 


j 


QBean 
public Validator«Person» myBeanValidator() ( 
return new MyBeanValidator«Person»(); 


} 


6. 数 据 输 出 


Spring Batch 为 我 们 提供 了 大 量 的 ItemWriter 的 
， 用 来 将 数据 输出 到 不 同 的 目的 地 ， 如 图 9- 
110g 


7 计划 任务 


Spring Batch 时 任务 是 通过 JobLauncher 的 run 
方法 来 执行 的 ， 因 此 我 们 只 需 在 普通 的 计划 任务 
方法 中 执行 JobLauncher 的 run 方 法 即 可 。 


BAN TSR, All FACE A 
(@EnableScheduling 开 启 计划 任务 支持 : 


QService 

public class ScheduledTaskService { 
@Autowired 
JobLauncher jobLauncher; 


@Autowired 
Job importJob; 


public JobParameters jobParameters; 
@Scheduled(fixedRate = 5000) 
public void execute() throws Exception { 
jobParameters = new JobParametersBuilder ( ) 
.addLong("time", 
System.currentTimeMillis()).toJobParameters(); 
jobLauncher.run(importJob, jobParameters); 
1 


frype hierarchy of 'org.springframework.batch.item.ItemWriter': Y 


4 OQ ItemWriter«T» - org.springframework.batch.item 


AmapltemWriter<T> - org.springframework.batch.item.amqp 
ClassifierCompositeltemWriter«T» - org.springframework.batch.item.support 
HibernateltemWriter«T» - org.springframework.batch.item.database 
IbatisBatchItemWriter«T» - org.springframework.batch.item.database 


ItemWriterAdapter«T» - org.springframework.batch.jsr.item 
ItemWriterAdapter<T> - org.springframework.batch.item.adapter 
JdbcBatchltemWriter«T» - org.springframework.batch.item.database 
JmsltemWriter«T» - org.springframework.batch.item.jms 
JpaltemWriter«T» - org.springframework.batch.item.database 
KeyValueltemWriter«K, V» - org.springframework.batch.item 


0000000000 


© GemfireltemWriter<K, V» - org.springframework.batch.item.data 

© SpELMappingGemfireltemWriter<K, V» - org.springframework.batch.item.data 
ListitemWriter«T» - org.springframework.batch.item.support 
MimeMessageltemWriter - org.springframework.batch.item.mail.javamail 
MongoltemWriter«T» - org.springframework.batch.item.data 
Neo4jltemWriter<T> - org.springframework.batch.item.data 
PropertyExtractingDelegatingltemWriter<T> - org.springframework.batch.item.adapter 
RepositoryltemWriter<T> - org.springframework.batch.item.data 
SimpleMailMessageltemWriter - org.springframework.batch.item.mail 


ItemStreamWriter<T> - org.springframework.batch.item 


© 
© 
© 
© 
© 
© 
© 
© 


Q^ AbstractitemStreamltemWriter<T> - org.springframework.batch.item.support 
© FlatFileitemWriter<T> - org.springframework.batch.item.file 
© MultiResourceltemWriter<T> - org.springframework.batch.item.file 
© StaxEventltemWriter«T» - org.springframework.batch.item.xml 

© CompositeltemWriter<T> - org.springframework.batch.item.support 

Q  ResourceAwareltemWriterltemStream «T» - org.springframework.batch.item.file 
© FlatFileltemWriter«T» - org.springframework.batch.item.file 
© StaxEventltemWriter<T> - org.springframework.batch.item.xml 


Press 'Ctrl«T' to see the supertype —À 


图 9-10 ”数据 输出 
8. 参 数 后 置 绑 定 


我 们 在 ItemReader 和 ItemWriter 的 Bean 定 义 的 
ee 
Uf: 


@Bean 
public ItemReader<Person> reader() throws Exception { 
FlatFileItemReader<Person> reader = new 
FlatFileItemReader<Person>(); 
reader .setResource(new 


ClassPathResource("people.csv")); 
return reader; 


} 


ARTE EEE CF E CL EE RR A CE 
Bean 的 定义 中 ， 这 在 很 多 情况 下 不 符合 我 们 的 实 
际 需求 ， 这 时 我 们 需要 使 用 参数 后 置 湖 定 。 


要 实现 参数 后 置 绑 定 ， 我 们 可 以 在 
JobParameters 中 绑 定 参数 ， 在 Bean 定 义 的 时 候 使 
用 一 个 特殊 的 Bean 生 命 周 期 注解 @StepScope， 然 
后 通过 @Value 注 入 此 参数 。 


参数 设置 : 


String path = "people.csv"; 


JobParameters jobParameters - new JobParametersBuilder() 
.addLong("time", System.currentTimeMillis()) 
.addString("input.file.name", path) 

. toJobParameters(); 


jobLauncher.run(importJob, jobParameters) ; 


^E Y Bean: 


QBean 
QStepScope 
public ItemReader<Person> reader (@Value("# 
{jobParameters['input.file.name']}") String pathToFile) 
throws Exception { 
FlatFileItemReader<Person> reader = new 
FlatFileItemReader<Person>(); 
reader .setResource(new 


ClassPathResource(pathToFile)); 
return reader; 


j 


9.2.2 Spring Booth] 3: FF 


Spring Boot 对 Spring Batch xz FFA) RAS f T 
org.springframework.boot.autoconfigure.batch 下 。 


Spring Boot 为 我 们 目 动 初始 化 了 Spring Batch 
存储 批 处 理 记 录 的 数据 库 ， 且 当 我 们 程序 启动 
时 ， 会 目 动 执 行 我 们 定义 的 Job 的 Bean。 


Spring Boot 提 供 如 下 属性 来 定制 Spring 
Batch: 


spring.batch.job.names=job1, job2 # 启 动 时 要 执行 的 Job， 默 认 执 行 全 译 
Job 

spring.batch.job.enabled-true # 是 否 自动 执行 定义 的 Job， 默 认为 是 
spring.batch.initializer.enabled-true # 是 否 初始 化 Spring Batch 
的 数据 库 ， 默 认为 是 

spring.batch.schema- 

spring.batch.table-prefix- # 设置 Spring Batch 的 数据 库 表 的 前 组 


9.2.3 ”实战 


本 例 将 使 用 9pring Batch 将 csv 文 件 中 的 效 据 使 
用 JDBC 批 处 理 的 方式 插入 数据 库 。 


1.3815 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 JDBC (spring- 
boot-starter-jdbc) ^ Batch (spring-boot-starter- 
batch) ^ Web (spring-boot-starter-web) » 


项 E 信息 : 


groupId: com.wisely 
arctifactId:ch9 2 
package: com.wisely.ch9 2 


VC EI fs& HHOracleJK5/, Spring Batch H 7) 
加 载 hsqldb 驱 动 ， 所 以 我 们 要 去 除 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter- 
batch</artifactId> 
<exclusions> 
<exclusion> 
«groupId»org.hsgldb 
«/groupId-» 
«artifactiId-hsqldb«/artifactId» 
«/exclusion» 
«/exclusions» 
«/dependency» 


«dependency» 
«groupId»com.oracle«c/groupId-» 


<artifactId>ojdbc6</artifactId> 
<version>11.2.0.2.0</version> 
</dependency> 


水 加 hibernate-validator 依 赖 ， 作 为 数据 校 验 使 
用 : 


<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-validator</artifactId> 
</dependency> 


测 斌 csv 数据 ， 位 于 
src/main/resources/people.csv 中 ， 内 容 如 下 : 


汪 某 某 , 11, 汉族 , 合肥 
张 某 某 ,12, 汉族 , 上 海 
李 某 某 , 13, EDGR, 武汉 
刘 某 , 14, 非 汉族 , 南京 
欧阳 某 某 , 115, 汉族 , 北京 


ZEREX, MF 
src/main/resources/schema.sql 中 ， 内 容 如 下 : 


create table PERSON 
( 


id NUMBER not null primary key, 
name VARCHAR2( 20), 

age NUMBER, 

nation VARCHAR2(20), 

address VARCHAR2( 20) 


); 


效 据 着 的 配置 与 表面 例 于 你 持 一 致 。 


2. 领 域 模型 类 


package com.wisely.ch9 2.domain; 
import javax.validation.constraints.Size; 
public class Person ( 


QSize(max-4,min-2) //1 
private String name; 


private int age; 
private String nation; 


private String address; 


// 省 略 getter、setter 方 法 
} 


代码 解释 

中 此 处 使 用 JSR-303 注 解 来 校 验 数 据 。 
3. 数 据 处 理 及 校 验 

(1) 处 理 : 


package com.wisely.ch9 2.batch; 


import 
org.springframework.batch.item.validator.ValidatingItemProce 
ssor; 

import 
org.springframework.batch.item.validator.ValidationException 


, 


import com.wisely.ch9 2.domain.Person; 


public class CsvItemProcessor extends 
ValidatingItemProcessor<Person>{ 


QOverride 
public Person process(Person item) throws 
ValidationException { 
super.process(item); //1 
if (item. getNation().equals("iM#K")){ //2 
item.setNation("01"); 
selse{ 
item.setNation("02"); 
} 


return item; 


代码 解释 


(DD) 需 执行 super.proces: (item) 727 H H E 
SURE AE ° 


G 对 数据 做 位 单 的 处 理 ， 知 民族 为 汉族 ， 则 
数据 转换 成 01， 其 余 转 换 成 02。 


(2) 校 验 : 


package com.wisely.ch9 2.batch; 
import java.util.Set; 
import javax.validation.ConstraintViolation; 


import javax.validation.Validation; 
import javax.validation.ValidatorFactory; 


Import 
org.springframework.batch.item.validator.ValidationException 


T 
import org.springframework.batch.item.validator.Validator; 
import org.springframework.beans.factory.InitializingBean; 


public class CsvBeanValidator<T> implements 
Validator<T>, InitializingBean { 
private javax.validation.Validator validator; 
@Override 
public void afterPropertiesSet() throws Exception { //1 
ValidatorFactory validatorFactory = 
Validation. buildDefaultValidatorFactory(); 
validator = 
validatorFactory.usingContext().getValidator(); 


} 


QOverride 
public void validate(T value) throws ValidationException 


{ 
Set<ConstraintViolation<T>> constraintViolations = 
validator.validate(value); //2 
if(constraintViolations.size()>0){ 
StringBuilder message = new StringBuilder(); 
for (ConstraintViolation<T> constraintViolation 
constraintViolations) { 


message.append(constraintViolation.getMessage() + "\n"); 


throw new 
ValidationException(message.toString()); 


j 


代码 解释 


OQ) 使 用 JSR-303 的 Validator 来 校 验 我 们 的 数 
据 ， 在 此 处 进行 JSR-303 的 Validator 的 初始 化 。 


2) 使 用 Validator 的 validate 方 法 校 验 数 据 。 


4.Job 监 听 


package com.wisely.ch9 2.batch; 


import org.springframework.batch.core.JobExecution; 
import org.springframework.batch.core.JobExecutionListener; 


public class CsvJobListener implements JobExecutionListener( 


long startTime; 

long endTime; 

QOverride 

public void beforeJob(JobExecution jobExecution) { 
startTime - System.currentTimeMillis(); 
System.out.println(" 任 务 处 理 开 始 " ) ; 

} 


QOverride 
public void afterJob(JobExecution jobExecution) { 
endTime - System.currentTimeMillis(); 
System.out.println(" 任 务 处 理 结 束 " ) ; 
System.out,.printlLn(" 耗 时 :" + (endTime - startTime) + 
"ms" ) : 


j 


代码 解释 


监听 需 实 现 JobExecutionListener 接 口 ， 并 重 写 
其 beforeJob ^ afterJob7; TE Bl] n ° 


5.B B 
配置 的 完成 代码 如 下 : 


package com.wisely.ch9 2.batch; 
import javax.sql.DataSource; 


import org.springframework.batch.core.Job; 

import org.springframework.batch.core.Step; 

import 
org.springframework.batch.core.configuration.annotation.Enab 
leBatchProcessing; 

import 
org.springframework.batch.core.configuration.annotation.JobB 
uilderFactory; 

import 
org.springframework.batch.core.configuration.annotation.Step 
BuilderFactory; 

import 
org.springframework.batch.core.launch.support.RunlIdIncrement 
er; 

import 
org.springframework.batch.core.launch.support.SimpleJobLaunc 
her; 

import 
org.springframework.batch.core.repository.JobRepository; 
import 
org.springframework.batch.core.repository.support.JobReposit 
oryFactoryBean; 

import org.springframework.batch.item.ItemProcessor; 

import org.springframework.batch.item.ItemReader; 

import org.springframework.batch.item.ItemWriter; 

import 
org.springframework.batch.item.database.BeanPropertyItemSqlP 
arameterSourceProvider; 

import 

org.springframework.batch.item.database. JdbcBatchItemwriter; 
import 
org.springframework.batch.item.file.FlatFileItemReader ; 
import 
org.springframework.batch.item.file.mapping.BeanWrapperField 


SetMapper; 

import 
org.springframework.batch.item.file.mapping.DefaultLineMappe 
r; 

import 
org.springframework.batch.item.file.transform.DelimitedLineT 
okenizer; 

import org.springframework.batch.item.validator.Validator; 
import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.core.io.ClassPathResource; 

import 
org.springframework.transaction.PlatformTransactionManager ; 


import com.wisely.ch9_2.domain.Person; 


@Configuration 
@EnableBatchProcessing 
public class CsvBatchConfig { 


@Bean 
public ItemReader<Person> reader() throws Exception { 
FlatFileItemReader<Person> reader = new 
FlatFileItemReader<Person>(); 
reader .setResource(new 
ClassPathResource("people.csv")); 
reader.setLineMapper (new 
DefaultLineMapper<Person>() {{ 
setLineTokenizer (new 
DelimitedLineTokenizer() (1 
setNames(new String[] { "name","age", 
"nation" ,"address"}); 
th); 
setFieldSetMapper (new 
BeanwrapperFieldSetMapper<Person>() {{ 
setTargetType(Person.class); 
th); 
33); 


return reader; 


j 


QBean 

public ItemProcessor«Person, Person» processor() ( 
CsvItemProcessor processor - new CsvItemProcessor(); 
processor.setValidator(csvBeanValidator()); 


return processor; 


j 


QBean 
public Itemwriter<Person> writer(DataSource dataSource) 


{ 

JdbcBatchItemwriter<Person> writer = new 
JdbcBatchItemwriter<Person>(); 

writer.setItemSqlParameterSourceProvider (new 
BeanPropertyItemSqlParameterSourceProvider<Person>()); 

String sql = "insert into person " + " 
(id,name,age,nation,address) " 

+ "values(hibernate_sequence.nextval, :name, 

:age, :nation, :address)"; 

writer.setSql(sql); 

writer.setDataSource(dataSource); 

return writer; 


j 


QBean 
public JobRepository jobRepository(DataSource 
dataSource, PlatformTransactionManager transactionManager ) 
throws Exception { 
JobRepositoryFactoryBean jobRepositoryFactoryBean - 
new JobRepositoryFactoryBean(); 
jobRepositoryFactoryBean.setDataSource(dataSource); 


jobRepositoryFactoryBean.setTransactionManager(transactionMa 
nager); 
jobRepositoryFactoryBean.setDatabaseType("oracle"); 
return jobRepositoryFactoryBean.getObject(); 


j 


QBean 
public SimpleJobLauncher jobLauncher(DataSource 
dataSource, PlatformTransactionManager transactionManager ) 
throws Exception { 
SimpleJobLauncher jobLauncher - new 
SimpleJobLauncher(); 


jobLauncher.setJobRepository(jobRepository(dataSource, 
transactionManager)); 
return jobLauncher; 


j 


QBean 
public Job importJob(JobBuilderFactory jobs, Step s1) { 
return jobs.get("importJob") 
.incrementer(new RunIdIncrementer()) 


.flow(s1) 
.end() 
.listener(csvJobListener()) 
.build(); 

} 

QBean 


public Step stepi(StepBuilderFactory stepBuilderFactory, 
ItemReader«Person» reader, ItemWriter«Person» writer, 
ItemProcessor«Person,Person» processor) ( 
return stepBuilderFactory 
.get("stepi") 
.<Person, Person>chunk( 65000) 
. reader (reader ) 
.processor (processor) 
„writer (writer) 
.build(); 
} 


QBean 

public CsvJobListener csvJobListener() ( 
return new CsvJobListener(); 

} 


QBean 

public Validator<Person> csvBeanValidator() { 
return new CsvBeanValidator<Person>(); 

} 


配置 代码 较 长 ， 我 们 将 拆 开 讲解 ， 自 和 完 我 们 
的 配置 类 要 使 用 @EnableBatchProcessing 开 局 批 处 
理 的 文 持 ， 这 点 于 万 不 要 环 记 。 


ItemReader 定 义 : 


QBean 
public ItemReader<Person> reader() throws Exception { 
FlatFileItemReader<Person> reader = new 
FlatFileItemReader<Person>(); //1 
reader .setResource(new 
ClassPathResource("people.csv")); //2 
reader .setLineMapper (new 
DefaultLineMapper<Person>() {{ //3 
setLineTokenizer (new 
DelimitedLineTokenizer() (1 
setNames(new String[] { "name","age", 
"nation" ,"address"}); 
th); 
setFieldSetMapper (new 
BeanwrapperFieldSetMapper<Person>() {{ 
setTargetType(Person.class); 
th); 
33); 


return reader; 


代码 解释 
使 用 FlatFileItemReader 该 取 文 件 。 


Cft FH FlatFileltemReaderfsetResource7; 7:3x 
置 csv 文 件 的 路 径 。 


(3) 在 此 处 对 cvs 文 件 的 数据 和 领域 模型 类 做 对 
FIBRAS e 


ItemProcessor*E Y : 


QBean 
public ItemProcessor«Person, Person» processor() { 
CsvItemProcessor processor - new CsvItemProcessor(); 


//1 
processor.setValidator(csvBeanValidator()); //2 
return processor; 


j 


QBean 
public Validator<Person> csvBeanValidator() { 
return new CsvBeanValidator<Person>(); 


} 
代码 解释 
使 用 我 们 目 己 定义 的 ItemProcessor 的 实现 


CsvItemProcessor ? 


(2)-N processors XE Bea as 7S 
CsvBean Validator; 


ItemWriterxe X.: 


@Bean 
public Itemwriter«Person» writer(DataSource dataSource) 
1774 
JdbcBatchItemWriter«Person» writer = new 
JdbcBatchItemwriter<Person>(); //2 
writer.setItemSqlParameterSourceProvider (new 
BeanPropertyItemSqlParameterSourceProvider<Person>()); 
String sql = "insert into person" + " 
(id,name,age,nation,address) " 
+ "values(hibernate_sequence.nextval, :name, 
:age, :nation, :address)"; 
writer.setSql(sql); //3 
writer.setDataSource(dataSource); 
return writer; 


代码 解释 


中 Spring 能 让 容 硕 中 已 有 的 Bean 以 参数 的 形式 
YEA, Spring Boot 已 为 我 们 定义 了 dataSource 。 


2 我 们 使 用 JDBC 批 处 理 的 
JdbcBatchItemwWriter 来 写 数 据 到 数据 库 。 


(3 在 此 设置 要 执行 批 处 理 的 SQL 语 句 。 
JobRepository 定 义 : 


QBean 
public JobRepository jobRepository(DataSource 
dataSource, PlatformTransactionManager transactionManager ) 
throws Exception { 
JobRepositoryFactoryBean jobRepositoryFactoryBean - 
new JobRepositoryFactoryBean(); 
jobRepositoryFactoryBean.setDataSource(dataSource); 


jobRepositoryFactoryBean.setTransactionManager(transactionMa 
nager); 
jobRepositoryFactoryBean.setDatabaseType("oracle"); 
return jobRepositoryFactoryBean.getObject(); 
} 


代码 解释 


jobRepository 的 定义 需要 dataSource 和 
transactioManager, Spring Boot 已 为 我 们 目 动 配置 
了 这 两 个 类 ，Spring 可 通过 方法 注入 已 有 的 Bean。 


JobLauncherŒ X.: 


QBean 
public SimpleJobLauncher jobLauncher(DataSource 
dataSource, PlatformTransactionManager transactionManager ) 
throws Exception { 
SimpleJobLauncher jobLauncher - new 
SimpleJobLauncher(); 


jobLauncher.setJobRepository(jobRepository(dataSource, 
transactionManager)); 
return jobLauncher; 


} 
Job 定 义 : 


QBean 
public Job importJob(JobBuilderFactory jobs, Step s1) { 
return jobs.get("importJob") 
.incrementer(new RunIdIncrementer()) 
.flow(s1) //1 


.end() 
.listener(csvJobListener()) //2 
.build(); 

} 

QBean 


public CsvJobListener csvJobListener() ( 
return new CsvJobListener(); 


) 
代码 解释 
(为 Job 指 定 Step ° 


(2) 绑 定 监听 器 csvJobListener。 


Step 定 义 : 


QBean 
public Step stepi(StepBuilderFactory stepBuilderFactory, 
ItemReader<Person> reader, ItemWriter«Person» writer, 
ItemProcessor«Person,Person» processor) ( 
return stepBuilderFactory 
.get("stepi") 
.«Person, Person»chunk(65000) //1 
.reader (reader) //2 
.processor (processor) //3 
.writer(writer) //4 
.build(); 
} 


代码 解释 

( 批 处 理 每 次 提交 65000 条 数据 。 
2) 给 step 绑 定 reader ° 

(3) 给 step 绑 定 processor。 

由 给 step 绑 定 writer。 

6. 运 行 


局 动 程 序 ，Spring Boot 会 目 动 初始 化 Spring 
Batch 数 据 库 ， 并 将 csv 中 的 数据 导入 到 数据 库 中 。 


为 我 们 初始 化 的 Spring Batch 数 据 库 如 图 9-11 
ZN ° 


H BATCH JOB EXECUTION 
BATCH JOB EXECUTION, CONTEXT 
b-EB BATCH JOB EXECUTION, PARAMS 


-BA BATCH JOB INSTANCE 
-BA BATCH STEP EXECUTION 
EE BATCH STEP EXECUTION CONTEXT 


图 9-11 Spring Batch 数 据 库 
di UT S SCR AU 9-129 7n ° 
数据 已 导入 且 做 转换 处 理 ， 如 图 9-13 所 示 。 


任务 处 理 开 始 
2015-07-22 21:59:47.424 


{Sees 
耕 时 :153ms 


图 9-12 ”监听 器 效果 


11 01 
12 01 


13 02 
14 02 
140 欧阳 其 其 … 115 01 


图 9-13 ”数据 已 导入 且 做 转换 处 理 
将 我 们 在 Person 类 上 定义 的 
@Size (max=4, min=2) 
修改 为 


@Size (max-3, min-2) ， 启 动 程序 ， 控 制 
台 输 出 校 验 销 误 ， 如 图 9-14 所 示 。 


xception: 个 数 必须 在 2 和 3 之 间 


at com .wisely.ch9 2.batch.CsvBeanValidator.validate(CsvBeanValidator.java:30) 
i i i r i in, mProcessor.process(ValidatingItemProcessor 


图 9-14 输入 校 验 错误 
7. 手 动 触 发 任务 
很 多 时 候 批 处 理 任务 古人 为 触发 的 ， 在 此 我 


们 添加 一 个 控制 如 ， 通 过 人 为 触发 批 处 理 任 务 ， 
并 演示 参数 后 置 绑 定 的 使 用 。 


注释 挥 CsvBatchConfig 类 的 @Configuration 注 
解 ， 让 此 配置 类 不 再 起 效 。 新 建 
TriggerBatchConfig 配 置 类 ， 内 容 与 
CsvBatchConfig 完 全 保持 一 致 ， 除 了 修改 定义 
ItemReader 这 个 Bean，ItemReader 修 改 后 的 定义 如 
下 : 


QBean 
QStepScope 
public FlatFileItemReader<Person> reader (@Value("# 
{jobParameters['input.file.name']}") String pathToFile) 
throws Exception { 
FlatFileItemReader<Person> reader = new 
FlatFileItemReader<Person>(); //1 
reader.setResource(new 
ClassPathResource(pathToFile)); //2 
reader .setLineMapper (new 
DefaultLineMapper<Person>() {{ //3 
setLineTokenizer (new 
DelimitedLineTokenizer() (1 
setNames(new String[] { "name","age", 
"nation" ,"address"}); 


了 
setFieldSetMapper (new 
BeanwrapperFieldSetMapper<Person>() {{ 
setTargetType(Person.class); 


th); 
}}); 


return reader; 


此 处 需 注 意 Bean 的 类 型 修改 为 
FlatFileltemReader, 而 不 是 ItemReader。 因 为 
ItemReader 捞 口中 没有 read 方 法 ， 知 使 用 


ItemReader 则 会 报 一 个 “Reader must be open before 
it can be read" fH TX ° 


控制 定义 如 下 : 


package com.wisely.ch9 2.web; 


import org.springframework.batch.core.Job; 

import org.springframework.batch.core.JobParameters; 

import org.springframework.batch.core.JobParametersBuilder; 
import org.springframework.batch.core.launch.JobLauncher; 
import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


QRestController 
public class DemoController { 
@Autowired 
JobLauncher jobLauncher; 
QAutowired 
Job importJob; 
public JobParameters jobParameters; 


QRequestMapping("/imp") 
public String imp(String fileName) throws Exception{ 
String path = fileName-".csv"; 
jobParameters - new JobParametersBuilder() 
.addLong("time", 
System.currentTimeMillis()) 
.addString("input.file.name", path) 
. toJobParameters(); 
jobLauncher.run(importJob, jobParameters); 
return "ok"; 


此 时 我 们 还 要 关闭 Spring Boot 为 我 们 目 动 执 
行 Job 的 配置 ， 在 application.properties 里 使 用 下 面 
代码 天 闭 配 置 : 


spring.batch.job.enabled-false 


此 时 我 们 访问 http://localhost: 8080/imp? 
fileName=people， 可 获得 相同 的 数据 导入 鸡 果 ， 
如 图 9-15 所 示 。 


4 E sy 
| [D [|NAME [AGE [|NATON _ [ADDRESS _ — SS PIT 
b 1| 141 E … 11 01 … 合肥 m localhost:8080/rea x Y 


12 01 “| 上海 — L 
| 13|02 -ax 二 | € Œ | D localhost:8080/rea 7? = | 
| 1402 ZL. NE | 

k 


… 115 01 … | 北京 -|f o | 


图 9-15 ”数据 导入 效果 


9.3 FARE 


异步 请 轧 主 要 目的 是 为 了 系统 与 系统 之 间 的 
通信 。 所 请 异步 消 恩 即 消 有 息 发 送 洗 无 须 等 每 消 轧 
FUNC a ADE IE], BAM RDI TERA 


ERA APSA MB BABS, BUB US, 
代理 (message broker) 和 目的 地 (destination) 
SYA BARS AGAR. YAR EHI VERB 
管 ， 消 明代 理 你 证 消 恩 传递 到 指定 的 目的 地 。 


异步 消息 主要 有 两 种 形式 的 目的 地 : 队列 
(queue) 和 主题 (topic) 。 队 列 用 于 点 对 点 式 
(point-to-point) 的 消息 通信 ; 主题 用 于 发 布 / 订 
阅 式 (publish/subscribe) 的 消 思 通信。 


LAT ZY 
FHEARRA RR E, TACHA 


后 将 消息 放 进 一 个 队列 (queue) E, SUBIRE 
Wee OR BCE SL AEN A, SRE AM] FB 


E A, A RDA E WA TARIK 


7D) 


Ja) OR AY) ze BE — FRYE RE) 20 
RAME, IR NE HUH — 1 BEAUR 
可 以 从 队列 里 接收 请 轧 。 因 为 队列 里 有 多 个 请 
忆 ， 氮 对 点 式 只 你 证 每 一 条 消 轧 只 有 唯一 的 发 送 
者 和 接收 者 。 


2. 发 布 /订阅 式 


ALAM AARDE, ACTH] DIDO AIR 
ALXAIH BEIM (topic) ， 而 多 个 消息 接收 者 监 
听 这 个 主题 。 此 时 的 消息 发 送 痢 和 接收 者 分 别 叫 
做 发 布 着 和 订阅 着 。 


9.3.1 企业 级 消息 代理 


JMS (Java Message Service) 即 Java 消 息 服 
25, wezeTIVMIE ACHEIVE © M ActiveMQ ^ 
HornetQzé— T JMSIH 轧 代 理 的 实现 7 


AMQP (Advanced Message Queuing 
Protocol) 也 是 一 个 消息 代理 的 规范 ， 但 它 不 仅 兼 


容 JMS， 还 支持 跨 语 言 和 平台 。AMQP 的 主要 实现 
A RabbitMQ ° 


9.3.2 ”Spring 的 支持 


Spring 对 JMS 和 AMQP 的 支持 分 别 来 自 于 
spring-jms 和 Spring-rabbit 。 


它们 分 别 需要 ConnectionFactory 的 实现 来 连接 
消 恩 代理 ， 并 分 别提 供 了 JmsTemplate 、 
RabbitTemplatest Zz 3X& 1H ks, ° 


Spring7jJMS ` AMQP f (QJmsListener ^ 
@RabbitListener 注 解 在 方法 上 监听 消 居 代理 发 布 
的 消 轧 。 我 们 需要 分 别 通 过 @EnableJms ^ 
@EnableRabbit 开 启 支 持 。 


9.3.3 ”Spring Boot 的 支持 


Spring Boot 对 JMS 的 目 动 配置 色 持 位 于 
org.springframework.boot.autoconfigure.jms F, 3X 
FJMS XIS ActiveMQ ` HornetQ ` Artemis 

(由 HornetQ 捐 赠 给 ActiveMQ 的 代码 库 形 成 的 
ActiveMQ 的 子 项 目 ) 。 这 里 我 们 以 ActiveMQ 为 


例 ， Spring Boot 为 我 们 定义 了 
ActiveMQConnectionFactory 的 Bean 作 为 连 氢 ， 并 
通过 “spring.activemq” 为 前 弧 的 属性 来 配置 
ActiveMQ 的 连接 属性 ， 包 含 : 


spring.activemq.broker-url-tcp://localhost:61616 # 消息 代理 的 
路 径 

spring.activemq.user- 

spring.activemq.password- 

spring.activemq.in-memory-true 

spring.activemq.pooled-false 


Spring Boot 在 JmsAutoConfiguration 还 为 我 们 
配置 好 了 JmsTemplate， 且 为 我 们 开 司 了 注解 式 消 
居 监 昕 的 支持 ， 即 目 动 开启 @EnableJms 。 


Spring Boot 对 AMQP 的 目 动 配置 文 持 位 于 
org.springframework.boot.autoconfigure.amqp F , 
它 为 我 们 配置 了 连接 的 ConnectionFactory 和 
RabbitTemplate, EKRI IIFA T 3x58 1B s 
听 ， 即 自动 开启 @EnableRabbit。RabbitMQ 的 配置 
可 通过 “spring.rabbitmq” 来 配置 RabbitMQ， 主 要 包 
dicor ER #rabbitmdq 端 口 ， 默 认为 5672 


spring.rabbitmq.username-admin 
spring.rabbitmq.password-secret 


9.3.4 ” JMS 实战 


1. 安 装 ActiveMQ 
(1) dEDocker X 
读者 可 访问 


http://activemq.apache.org/activemq-5111- 
release.html， 下 载 合适 的 ActiveMQ 有 版 本 。 


(2) Docker 安 装 


前 面 已 经 下 载 好 了 ActiveMQ 的 镜像 ， 我 们 可 
以 通过 下 面 命令 运行 锐 像 : 


docker run -d -p 61616:61616 -p 8161:8161 
cloudesire/activemq 


H P6116167 EARE m, 8161z& 
ActiveMQB E EA Alvin, Baala I TE 
VirtualBox 开 启 61616 及 8161 的 端口 映射 。 


访问 http:Wlocalhost: 8161 可 打开 ActiveMQ 的 
管理 界面 ， 管 理 员 账 号 密码 默认 为 admin/admin ， 
如 图 9-16 所 示 。 


(3) PJERActiveMQ 


我 们 可 以 将 ActiveMQ 内 骸 在 程序 里 ， 只 要 在 


m E] fO E HIA activemq-brokerBl n] ° 


«dependency» 


«groupId»org.apache.activemq«c/groupId» 


<artifactId>activemg-broker</artifactId> 
</dependency> 


MIU Apache ActiveMQ 


x 
| | Q [5m 


n Mee." Apach 
ActiveMQ us 


Software Foundation 
http://www.apache.org/ 


Support 
Welcome to the Apache ActiveMQ! E Useful Links 
» a Documentation 

What do you want to do next? 


= Downloads 
i Forums 

m Manage ActiveMQ broker 

m See some Web der 


demos not included in default configuration) 


Copyright 2005-2013 The Apache Software Foundation. 


EIE 


图 9-16 ”ActiveMQ 的 管理 界面 


239r Spring Boot 项 目 


STÆ Spring Boot 项 目 ， 依 赖 无 。 


项 H 信息 : 


groupId: com.wisely 
arctifactId:ch9 3 4 


package: com.wisely.ch9 3 4 


虽然 Spring Boot 提 供 了 JMS (spring-boot- 
starter-hornetq) 的 依赖 ， 但 默认 我 们 使 用 的 消息 
代理 是 HornetQ ， 本 例 将 以 ActiveMQ 为 例 ， 所 以 
我 们 需要 添加 spring-jms 和 activemq-client 的 依赖 ， 
所 需 的 完成 依赖 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-jms</artifactId> 

</dependency> 


<dependency> 
<groupId>org.apache.activemq</groupId> 


<artifactId>activemq-client</artifactId> 
</dependency> 


Fi ELActiveMQTH SHH ask, dE 
application.properties # {5 Hj : 


spring.activemq.broker-url-tcp://localhost:61616 


ELME P. TARA AC Te NUBEIDUE Tx 
部 征 分 开 的 ， 而 这 里 我 们 为 了 演示 简单， 将 消 妃 
发 送 首 和 接收 着 放 在 一 个 程序 里 。 


= 


定义 JMS 发 送 的 消息 需 实 现 MessageCreator 接 
口 ， 并 重 写 其 createMessage 方 法 : 


package com.wisely.ch9 3 4; 


import javax.jms.JMSException; 
import javax.jms.Message; 
import javax.jms.Session; 


import org.springframework.jms.core.MessageCreator; 
public class Msg implements MessageCreator{ 

QOverride 

public Message createMessage(Session session) throws 


JMSException { 
return session.createTextMessage ("WNE"); 


j 


4. 消 妃 发 送 及 目的 地 定义 


package com.wisely.ch9 3 4; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.CommandLineRunner; 

import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplication 


import org.springframework.jms.core.JmsTemplate; 
QSpringBootApplication 
public class Ch934Application implements CommandLineRunner { 


//1 


QAutowired 
JmsTemplate jmsTemplate; //2 


public static void main(String[] args) { 
SpringApplication.run(Ch934Application.class, args); 


} 

QOverride 

public void run(String... args) throws Exception ( 
jmsTemplate.send("my-destination", new Msg()); //3 

} 


} 
代码 解释 


@Spring Boot 为 我 们 提供 了 
CommandLineRunner 接 口 ， 用 于 程序 局 动 后 执行 
的 代码 ， 通 过 重 写 其 run 方 法 执行 。 


DIEA Spring Boot 为 我 们 配置 好 的 
JmsTemplate 的 Bean。 


9) 通过 JmsTemplate 的 send 方 法 癌 my- 
destination H WHE X&MsgHJ1H A, 3x ESSET E 
消 妃 代理 上 定义 了 一 个 目的 地 叫 my-destination 。 


5.1 s di UT 


package com.wisely.ch9 3 4; 


import org.springframework.jms.annotation.JmsListener; 
import org.springframework.stereotype.Component; 


@Component 


public class Receiver ( 


QJmsListener(destination - "my-destination") 
public void receiveMessage(String message) { 
System.out.println("E£5 28]: <" + message + ">"); 


代码 解释 


(QJmsListenerzéSpring 4.1 为 我 们 提供 的 一 个 
新 特性 ， 用 来 简化 JMS 开 发 。 我 们 只 需 在 这 个 注 
解 的 属性 destination 指 定 要 监听 的 目的 地 ， 即 可 接 
收 该 目的 地 发 送 的 消 恩 。 此 例 监 昕 my-destination 
目的 地 发 送 的 消 轧 。 


6. 运 行 


局 动 程 序 ， 程 序 会 目 动 辐 目的 地 my- 
destination)“ Æ, Mi Receivery} fg 
@JmsLisener 的 方法 会 目 动 监听 my-destination 发 送 
HBR o 


fit m zxReceiverE IAE] E. AmÉo-17 
所 示 。 


2015-07-23 15:55:04.018 
2015-07-23 15:55:04.070 
2015-07-23 15:55:04.979 


2015-07-23 15:55:05.126 


2015-07-23 15:55:05.529 


接收 到 : < 测 | 式 ; 朋 县 > 


图 9-17 已 接 收 到 消息 


企 ActiveMQ 的 管理 页 面 也 可 以 查看 我 们 目的 
地 的 相关 信息 ， 如 图 9-18 所 示 。 


Number Of Pending Messages Number Of Consumers Messages Enqueued Messages Dequeued Views Operations 
Bı Acti 


my-destination 0 


irowse Active Consumers 
Active Producers Send To Purge Delete 


图 9-18 查看 目的 地 的 相关 信息 


9.3.55 AMQP 实 战 


1. 安 装 RabbitMQ 


(1) 非 Docker 安 装 


RabbitMQ 是 基于 erlang 语 言 开 发 的 ， 所 以 安 
闭 RabbitMQ 完 要 下 载 安 狼 erlang， 下 载 地 址 为 
http://www.erlang.org/download.html; 然后 下 载 
RabbitMQ, ， 下 载 地 址 为 


https://www.rabbitmq.com/download.html ° 
(2) Docker %3% 
前 面 已 经 下 载 好 了 RabbitMQ 的 镜像 ， 以 下 面 


docker run -d -p 5672:5672 -p 15672:15672 rabbitmq:3- 
management 


其 中 5672 是 消息 代理 的 端口 ，15672 是 Web 管 
理 界 面 的 端口 ， 我 们 使 用 的 是 市 管理 界面 的 
RabbitMQ; 最 后 还 要 在 VirtualBox 做 以 下 这 两 个 端 
口 的 映射 。 


访问 http:Wlocalhost: 15672， 打 开 管 理 界 面 ， 
默认 账号 密码 为 guest/guest， 如 图 9-19 所 示 。 


一 ESSI] 
eme X 


itMQ Manageme 
| tet 一 
| € c localhost:15672/# j = 
| 
> User: guest | ut 
a It Cluster: rabbit&741ccafd3b64 (change) — 
RabbitMQ 3.5.3, Erlang 17.5.3 
Connections Channels Exchanges Queues Admin 
Overview 


Totals 


Unacked 


图 9-19 ”RabbitMQ 管 理 界面 
2. 源 建 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 AMQP (spring- 
boot-starter-amqp) ° 


项 E 信息 : 


groupId: com.wisely 
arctifactId:ch9 3 5 
package: com.wisely.ch9 3 5 


Spring Boot 默 认 我 们 的 Rabbit 主 机 为 
localhost ^ m 1735672, PrEAdAI 762A Spring 
BootH‘Japplication.properties#c =. RabbitMQHy i= 42 
aa ws =| 6 


HD 


3. 发 送信 息 及 目的 地 定义 


package com.wisely.ch9 3 5; 


import org.springframework.amqp.core.Queue; 

import org.springframework.amqp.rabbit.core.RabbitTemplate; 
import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.CommandLineRunner; 

import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplication 


T 
import org.springframework.context.annotation. Bean; 


QSpringBootApplication 

public class Ch935Application implements CommandLineRunner { 
@Autowired 
RabbitTemplate rabbitTemplate; //1 


public static void main(String[] args) { 
SpringApplication.run(Ch935Application.class, args); 


} 


@Bean //2 

public Queue wiselyQueue( ){ 
return new Queue( "my-queue"); 

} 


@Override 
public void run(String... args) throws Exception { 
rabbitTemplate.convertAndSend("my-queue", "来 自 
RabbitMQ 的 问候 "); //3 
} 


} 


代码 解释 


DENEA Spring Boot 为 我 们 自动 配置 好 的 
RabbitTemplate ° 


Go 定义 目的 地 即 队列 ， 队 列 名 称 为 my- 


queue ? 


GST RabbitTemplate HJconvertAndSend7; /# 
癌 队列 my-queue 发 送 消息 © 


4. 消 息 监 听 


package com.wisely.ch9 3 5; 


import 
org.springframework.amqp.rabbit.annotation.RabbitListener; 
import org.springframework.stereotype.Component; 


QComponent 
public class Receiver ( 


QRabbitListener(queues - "my-queue") 


public void receiveMessage(String message) { 
System.out.println("Received <" + message + "»"); 


代码 解释 


使 用 @RabbitListener 来 监听 RabbitMQ 的 目的 
REOS 通过 queues 属 性 指定 要 监听 的 有 目 


5. 运 行 


启动 程序 ， 程 序 会 目 动 问 目 的 地 my-queue 发 
AVA, MReceiver}t## [ @RabbitListenerH) 77 


法 会 目 动 监听 my-queue 发 送 的 消 妃 。 
控制 台 显 示 如 图 9-20 所 示 。 


2015-07-23 17:14:50.407 
2015-87-23 17:14:50.807 
2015-07-23 17:14:50.913 


2015-87-23 17:14:51.042 


2015-07-23 17:14:51.119 


INFO 
INFO 
INFO 
INFO 
INFO 


Received «3kBjRabbitMQfBju]fs > 


图 9-20 HA 


RabbitMQ 管 理 寞 面 显示 如 图 9-21 所 示 。 


my-queue D idle 0 0 0 0.00/s 


Overview Messages Message rates 
Name Features State Ready  Unacked Total incoming deliver / get ack 
0.00/s 0.00/s 


图 9-21 ”RabbitMQ 管 理 界面 


9.4 系统 集成 Spring Integration 
9.4.1 Spring Integration [RIK AI | 


Spring Ingegrationfe Dt T 4 SpringHJEIP 
(Enterprise Integration Patterns， 企 业 集 成 模式 ) 
的 实现 。Spring Integration 主 要 解决 的 问题 是 不 同 
系统 之 间 区 互 的 问题 ， 通 过 异步 消息 张 动 来 达到 

系统 交互 时 系统 之 间 的 松 耘 合 。 本 和 将 基于 无 
XML 配置 的 原则 使 用 Java 配 置 、 注 解 以 及 Spring 
Integration Java DSL 来 使 用 Spring Integration ° 


Spring Integratin 主 要 由 Message、Channel 和 
Message EndPoint 组 成 。 


9.4.2 Message 


Message 是 用 来 在 不 同 部 分 之 则 传递 的 数据 。 
Message 由 两 部 分 组 成 : 消息 体 (payload) 与 消息 
头 (header) 。 消 息 体 可 以 是 任何 数据 类 型 (如 


XML、JSON，Java 对 象 ) ; 消息 头 表 示 的 元 数据 
就 是 解释 消息 体 的 内 容 。 


public interface Message<T> { 
T getPayload(); 
MessageHeaders getHeaders(); 


9.4.3 Channel 


(HB RAR oe 
(Channel) ， 消 息 收受 者 从 通道 (Channel) 接收 
消息 。 


1. 顶 级 接口 
(1) MessageChannel 


MessageChannelzéSpring Integration} 38i 38 


的 顶级 接口 : 


public interface MessageChannel { 
public static final long INDEFINITE TIMEOUT - -1; 
boolean send(Message<?> message); 
boolean send(Message<?> message, long timeout); 


j 


当 使 用 send 方 法 发 送 消 思 时， 返回 全 为 true， 
则 表示 消 轧 发 送 成 功 。MessageChannel 有 了 两 大 子 接 


口 ， 分 别 为 PollableChannle (可 轮 询 ) 和 
SubscribableChannel 〈 可 订阅 ) 9 S4 P8 BJ S. 
通道 类 都 是 实现 这 两 个 接口 。 


(2) PollableChannel 


PollableChannel 具 备 轮 询 获 得 消 轧 的 能 力 ， 害 
N 
AATF: 
public interface PollableChannel extends MessageChannel { 
Message<?> receive(); 


Message<?> receive(long timeout); 


} 
(3) SubscribableChannel 


SubscribableChannel 23475 I Z5 Y] [ia] T 
MessageHanldertJ i] [58 E : 


public interface SubscribableChannel extends MessageChannel 


boolean subscribe(MessageHandler handler); 
boolean unsubscribe(MessageHandler handler); 


j 
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(1) PublishSubscribeChannel 


PublishSubscribeChannel 人 允许 广播 消 因 给 所 有 
订阅 者， 配置 方式 如 下 : 


QBean 
public PublishSubscribeChannel publishSubscribeChannel() 


PublishSubscribeChannel channel = new 
PublishSubscribeChannel(); 
return channel; 
} 


HB, ig ROEDOERJid7J 
publishSubscribeChannel ° 


(2) QueueChannel 


QueueChannel 21715 Il Eel E EG YR TR a es , 
用 一 个 队列 (queue) 接收 消息 ， 队 列 的 容量 大 小 
可 配置 ， 配 置 方式 如 下 : 


QBean 

public QueueChannel queueChannel(){ 
QueueChannel channel - new QueueChannel(10); 
return channel; 


j 


其 中 QueueChannel 构 造 参数 10 即 为 队列 的 容 


o 


val 


(3) PriorityChannel 


PriorityChannel 可 按照 优先 级 将 数据 存储 到 
s I AEE ucc GU LE art, MAD 
XU: 


QBean 

public PriorityChannel priorityChannel(){ 
PriorityChannel channel - new PriorityChannel(10); 
return channel; 


j 


(4) RendezvousChannel 


RendezvousChannel 硝 保 每 一 个 接收 者 都 接收 
SITE JAB AAI, ACS OSE: 


@Bean 

public RendezvousChannel rendezvousChannel(){ 
RendezvousChannel channel = new RendezvousChannel(); 
return channel; 


(5) DirectChannel 


DirectChannelzé pans Integration iA i 1 E 局 
通道 ， 它 介 许 将 消息 发 送 给 为 一 个 订阅 者 ， 然 后 
阻碍 发 送 直 到 消 居 被 接收 ， 配 置 方 式 如 下 : 


QBean 

public DirectChannel directChannel(){ 
DirectChannel channel - new DirectChannel(); 
return channel; 


j 


(6) ExecutorChannel 


ExecutorChannel 可 绑 定 一 个 多 线程 的 task 
executor， 配 置 方式 如 下 : 


QBean 
public ExecutorChannel executorChannel( ){ 
ExecutorChannel channel - new 
ExecutorChannel(executor()); 
return channel; 


j 


QBean 

public Executor executor(){ 

ThreadPoolTaskExecutor taskExecutor = new 

ThreadPoolTaskExecutor(); 

taskExecutor.setCorePoolSize(5); 
taskExecutor.setMaxPoolSize(10); 
taskExecutor.setQueueCapacity(25); 
taskExecutor.initialize(); 
return taskExecutor; 


3. 通 道 拦截 需 


Spring Integration 给 消 轧 通道 提供 了 通道 拦截 
as (ChannelInterceptor) ， 用 来 拦截 发 送 和 接收 消 
县 的 操作 。 


ChannelInterceptor 接 口 定 义 如 下 ， 我 们 只 和 需 实 
现 这 个 接口 即 可 : 


public interface ChannelInterceptor { 
Message<?> preSend(Message«?» message, MessageChannel 


channel); 

void postSend(Message<?> message, MessageChannel 
channel, boolean sent); 

void afterSendCompletion(Message<?> message, 
MessageChannel channel, boolean sent, Exception ex); 

boolean preReceive(MessageChannel channel); 

Message<?> postReceive(Message<?> message, 
MessageChannel channel); 

void afterReceiveCompletion(Message<?> message, 
MessageChannel channel, Exception ex); 


qa PETI FH CB charmed 


channel.addInterceptor(someInterceptor); 


9.4.4 Message EndPoint 


消息 端点 (Message Endpoint) 是 真正 处 理 消 
JAN (Message) 组 件 ， 它 还 可 以 控制 通道 的 路 
由 。 我 们 可 用 的 消息 端点 包 合 如 下 : 


(1) Channel Adapter 
通道 适配器 (Channel Adapter) 是 一 种 连接 外 


部 系统 或 传输 协议 的 端点 (EndPoin) ， 可 以 分 为 
入 站 (inbound) 和 出 站 (outbound) 。 


Ea AC ae HR [R]HJ, Awa ices A X 
持 接 收 请 息 ， 出 站 通道 适 配 囊 只 文 抹 输 出 消 轧 。 
Spring Integration 内 置 了 如 下 的 适配器 : 
RabbitMQ ^ Feed ^ File ^ FTP/SFTP ^ 
Gemfire ` HTTP ` TCP/UDP ` JDBC ` JPA ` JMS ^ 


Mail ` MongoDB ^ Redis ` RMI ^ Twitter ^ XMPP ^ 
WebServices (SOAP ` REST) ` WebSocket= » 


Spring Integration extensions 项 目 提 供 了 更 多 的 
支持 ， 地 址 为 : https://github.com/spring- 
projects/spring-integration-extensions ° 


(2) Gateway 


iE (Gateway) 类 似 于 Adapter， 但 是 提 
供 了 双 回 的 请 求 /返回 集成 方式 ， 也 分 为 入 站 
(inbound) 和 出 站 (outbound) 。Spring 
Integration 对 相应 的 Adapter 多 都 所 供 了 Gateway 。 


(3) Service Activator 


Service Activator 可 调用 Spring 的 Bean 来 处 理 消 
居 ， 并 将 处 理 后 的 结 来 输出 到 指定 的 消 忌 通道 。 


(4) Router 


路 由 (Router) 可 根据 消息 体 类 型 (Payload 
Type Router) 、 消 息 头 的 值 (Header Value 
Router) 以 及 定义 好 的 接收 表 (Recipient List 
Router) 作为 条 件 ， 来 决定 消息 传递 到 的 通道 。 


(5) Filter 


过 滤器 (Filter) 类 似 于 路 由 (Router) ， 不 同 


的 是 过 滤器 不 决定 消 居 路 由 到 哪里 ， 而 古 决 定 消 
思 坪 人 否 可 以 传递 给 消息 通道 。 


(6) Splitter 


Hróar (Splitter) 将 消息 拆 分 为 几 个 部 分 单独 
处 理 拆 分 古 处 理 的 返回 值 是 一 个 集合 或 者 数 
组 。 

(7) Aggregator 


聚合 器 (Aggregator) 与 拆 分 器 相反 ， 它 接收 
一 个 java.util.List 作 为 参数 ， 将 多 个 消 恩 合并 为 一 
ÁN 
| 75 E. 9 


(8) Enricher 


当 我 们 从 外 部 获得 消 恩 后 ， 需 要 增加 额外 的 
RPI AAA, IY gr Bee AYE a 


az (Enricher) 。 消 息 增 强 器 主要 有 消息 体 增 强 器 
(Payload Enricher) 和 消息 头 增强 器 (Header 
Enricher) 两 种 。 


(9) Transformer 


转换 器 (Transformer) 是 对 获得 的 消息 进行 
一 定 的 逻辑 转换 处 理 (如 数据 格式 转换 ) 。 


(10) Bridge 


使 用 连接 桥 (Bridge) 可 以 简单 地 将 两 个 消息 
通道 连接 起 来 。 


9.4.5 Spring Integration Java DSL 


Spring Integrationfe ft T — T IntegrationFlow?f 
定义 系统 继承 流程 ， 而 通过 IntegrationFlows 和 
IntegrationFlowBuilder 来 实现 使 用 Fluent API 来 定义 
流程 。 在 Fluent API 里 ， 分 别提 供 了 下 面 方法 来 映 
射 Spring Integration 的 端点 (EndPoint) 。 


transform() -> Transformer 

filter() -> Filter 

handle() -> ServiceActivator » Adapter ` Gateway 
split() -> Splitter 

aggregate() -> Aggregator 


route() -> Router 
bridge() -> Bridge 


个 商 单 的 流程 定义 如 下 : 


QBean 
public IntegrationFlow demoFlow() { 

return IntegrationFlows.from("input") // 人 channel 

input 获 取消 息 


.<String, 
Integer>transform(Integer::parseInt) // 将 消息 转换 成 整数 
.get(); // 获 得 集成 流程 并 注册 为 Bean 
} 


9.46 A 


IK SEHBUR E Ahttps://spring.io/blog.atomAy#T 
同 聚 合 文件 ，atom 古 一 种 xml 文 件 ， 且 格式 是 固定 


«?xml version="1.0" encoding="UTF-8"?> 

«feed xmlns="http://www.w3.org/2005/Atom"> 
<title>Spring</title> 
«link rel="alternate" href="https://spring.io/blog" /> 
<link rel="self" href="https://spring.io/blog.atom" /> 
<id>http://spring.io/blog.atom</id> 
<icon>https://spring.io/favicon.ico</icon> 
<updated>2015 -07-29T14: 46: 00Z</updated> 


<entry> 
<title>Spring Cloud Connectors 1.2.0 
released</title> 
«link rel="alternate" href="http://..." /> 
<category term="releases" label="Releases" /> 
<author> 


<name>some author 


</name> 
</author> 
<id>tag:spring.i0, 2015-07-27:2196</id> 
<updated>2015 -07-29T14: 46: 00Z</updated> 
«content type="html">...</content> 
</entry> 
</feed> 


我 们 将 读 取 到 到 消息 通过 分 类 (Category) , 
将 消 忆 转 到 不 同 的 消 因 通道， 将 分 类 为 releases 和 
engineeringÉ 7H AS x AREF, FE oP A news i) 
消息 通过 邮件 发 送 


1.391 && Spring Boot 项 目 


渐 建 Spring Both H, KRA Integration 
(spring-boot-starter-integration) 和 mail (spring- 
boot-starter-mail) 。 


项 E fe Ei : 


groupId: com.wisely 
arctifactId:ch9 4 
package: com.wisely.ch9 4 


Zh, Sei b 3EBSIIISpring Integration*] atom 
及 mail 的 文 持 。 


<dependency> 


«groupId»org.springframework.integrationc/groupId» 
<artifactId>spring-integration-feed</artifactId> 


</dependency> 
<dependency> 


«groupId»org.springframework.integrationc/groupId» 


<artifactId>spring-integration-mail</artifactId> 


</dependency> 


本 例 的 所 有 代码 都 在 入 口 类 中 完成 。 
2. 读 取 流 程 
@Value("https://spring.io/blog.atom") // 1 


Resource resource; 


QBean(name = PollerMetadata.DEFAULT POLLER) 
public PollerMetadata poller() { //2 
return Pollers.fixedRate(500).get(); 


j 


QBean 


public FeedEntryMessageSource feedMessageSource() throws 


IOException ( //3 
FeedEntryMessageSource messageSource - new 
FeedEntryMessageSource(resource.getURL(), "news"); 
return messageSource; 


j 


QBean 
public IntegrationFlow myFlow() throws IOException { 
return IntegrationFlows.from(feedMessageSource( ) ) 
//4 
.«SyndEntry, String» route(payload -» 
payload.getCategories().get(0).getName(), //5 
mapping -> 

mapping.channelMapping("releases", "releasesChannel") //6 


.channelMapping("engineering", "engineeringChannel") 
.channelMapping("news", 
"newsChannel")) 


.get(); // 7 


代码 解释 


QU 通过 @value 注 解 目 动 获得 
https:Wspring.io/blog.atom 的 资源 。 


2) 使 用 Fluent API 和 Pollers 配 置 默认 的 轮 询 方 


@FeedEntryMessageSource 实 际 为 feed: 
inbound-channel-adapter, HEAREN A E feed] A yit 
Ee Bose FAREA © 


(4) 流 程 从 from 方 法 开始 。 


器 通过 路 由 方法 route 来 选择 路 由 ， 消 息 体 
(payload) m 作为 判断 条 件 的 
类 型 为 String， 判 断 的 值 是 通过 payload 获 得 的 分 类 
(Categroy) ; 


OH AA] 47 2S BJ LEES T8] AP F8] BJ S JEDE. i 
分 类 为 releases， 则 转 同 releasesChannel; EDK 
engineering, Jll|# [=] engineeringChannel; REN 
news， 则 转 癌 newsChannel。 


(7) 通 过 get 方 法 获得 IntegrationFlow 实 体 ， 配 置 
为 Spring 的 Bean。 


3.releases 流 程 


QBean 
public IntegrationFlow releasesFlow() { 
return 
IntegrationFlows.from(MessageChannels.queue("releasesChannel 
", 10)) 772 
.«SyndEntry, String» transform( 
payload -> " (" + payload.getTitle() 
+ ") " + payload.getLink() + getProperty("line.separator")) 
//2 
.handle(Files.outboundAdapter(new File("e:/ 
springblog")) //3 
.fileExistsMode(FileExistsMode.APPEND) 
.charset("UTF-8") 
.fileNameGenerator(message -> 
"releases.txt") 
.get()) 
.get(); 
} 


代码 解释 
qd) 从 消息 通道 releasesChannel 开 始 获取 数据 9 


使 用 ransform 方 法 进行 数据 转换 。payload 
类 型 力 SyndEntry， 将 其 转换 为 字符 串 类 型 ， 并 目 
定义 数据 的 格式 。 


(3) 用 handle 方 法 处 理 file 的 出 站 适配器 。Files 类 
7= H Spring Integration Java DSL 提 供 的 Fluent API 用 


来 构造 文件 输出 的 适配器 。 
4.engineering 流 程 


QBean 
public IntegrationFlow engineeringFlow() { 
return 
IntegrationFlows.from(MessageChannels.queue("engineeringChan 
nel", 10)) 
.«SyndEntry, String» transform( 
e -> "«" + e.,getTitle() +") "+ 
e.getLink() + getProperty("line.separator")) 
.handle(Files.outboundAdapter(new 
File("e:/springblog")) 


.fileExistsMode(FileExistsMode.APPEND) 
.charset("UTF-8") 
.fileNameGenerator(message -» 

"engineering.txt") 

.get()) 
.get(); 


代码 解释 
与 releases 流 程 相同 。 


5.news 流 程 


QBean 
public IntegrationFlow newsFlow() { 
return 

IntegrationFlows.from(MessageChannels.queue("newsChannel", 
10)) 

.«SyndEntry, String» transform( 

payload -> " (" + payload.getTitle() 

+ ") " + payload.getLink() + getProperty("line.separator")) 

.enrichHeaders( //1 


Mail.headers() 

.Subject(" 来 自 Spring 的 新 闻 " ) 

.to("wisely-man@126.com" ) 

.from("wisely-manQ126.com")) 

.handle(Mail.outboundAdapter("smtp.126.com") 

//2 

.port(25) 

.protocol("smtp") 


.credentials("wisely-manQ126.com", 
PETS] 


.javaMailProperties(p -> 
p.put("mail.debug", "false")), e -» e.id("smtpOut")) 
.get(); 
} 


代码 解释 
(通过 enricherHeader 来 增加 消息 头 的 信息 。 


邮件 发 送 的 相关 信息 通过 Spring Integration 
Java DSLt#e tB JMaill'Jheaders77 IE KRIE © 


(3) 使 用 handle 方 法 来 定义 邮件 发 送 的 出 站 适 配 
az, (8 Spring Integration Java DSL 提 供 的 
Mail.outboundAdapter 来 构造 ， 这 里 使 用 wisely- 
man@126.comHb#a la] BC AIRE © 
6. 运 行 
(1) 写 文 件 结果 


AFE: Wpringblog H5*, AHA lr Wi x. 
件 ， 如 图 9-22 所 示 。 


engineerin releases 
g 


图 9-22 springblag H5 


engineering.txt 文 件 内 容 如 图 9-23 所 示 。 


| Lf E\springblog\engineering tx - 
| AH SE) BRS) 视图 (V) 格式 (M) 语言 (L) BED 去 (O) BAR BAP) BOW ? 
> «HH obel AA D C|M ^g| * [O3 C3| s v (JI]CO (3) V) | fe 0n (2 ie) 


百 engineering. txt 加 | 


(This Week in Spring - July 7th, 2015) https://spring.io/blog/2015/07/07/this-week-in-spr =; —7th-2015 
(Spring IO Platform 1.1.3 released) https://spring.io/blog/2015/07/13/spring-io-platform-1-1-3-released 
(Microservices with Spring). h ://spring.io, 7/14/microservices-with- i 

(This Week in Spring - July i4th 2015) z ing.i 7 i 

(This Week in Spring - July 21, 2015) s://8 :io/blo 07. 

(This Week in Spring - July 28, 2015) https://spring.io/blog/2015/07/29/this-week-in-spring-iuly-28-2015 


Normal text file length:647 lines :7 Ln:1 Col:1 Sel:0|0 DosWindows UTF-8 w/o BOM INS 


[9-23 ”engineering.txt 文 件 内 容 


releases.txt 文 件 内 容 如 图 9-24 所 示 。 


|| X9 RE RESO WAV 格式 (M) meu 设 0) 宏 (O) 运行 (R) 插件 (P) BOW ? 
JBR onald t| 2 C|&^a| t «| 3| 0 9 (IE (9 | Teva eis 


o D veleaces. xt 


(Hibernate, Jackson, Jetty etc support in Spring 4.2) A i 7 i - 一 -etc-s ^ 
(spring Boot 1.2.5 released). https://spring.io/blog/2015/07/02/spring-boot-1-2-S-released fi 
(Spring Integration 4.2 Milestone 2 is Available (and 4.1.6)). https://spring.io/blog/2015/07/07/spring-integration-4-| 
(spring Boot 1.3.0.M2 Available Now). https://spring.io/blog/2015/07/10/spring-boot-1-3-0-m2-available-now 

(spring Framework 4.2 RC3 released / GA on July 30) nhztps://spring.io/b1og/2015/07/15/spring-framework-4-2-rc3-releas| 


(Spring Rog 2.0.0.M1 zefactors addons, structures for collaboration)... https://spring.io/blog/2015/07/20/spring-roo-2-0 三 
(spring Security 4.0.2 Released). https://spring.io/blog/2015/07/23/spring-security-4-0-2-released 

(Spring Security 3.2.8 Released). https: //spring.io/blog/2015/07/23/spring-security-3-2-8-released 

(Spring Security Kerberos 1.0.1 Released) https://spring.io/blog/2015/07/24/spring-security-kerberos-1-0-1-released 
(Spring Data Fowler SR2 released) https://spring.io/blog/2015/07/28/spring-data-fowler-sr2-released 

(Spring XD 1.2.1 Released) https://spring.io/blog/2015/07/28/spring-xd-1-2-1-released 

(Spring Cloud Connectors 1.2.0 released) https://spring.io/blog/2015/07/29/spring-cloud-connectors-1-2-0-released 


" j 


length:1463 lines : 13 tn:1 Col:1 Sel: 919 Dos\Windows UTF-8 w/o BOM INS 


图 9-24 releases.txt oC FF PA] ZX 


(2) 邮箱 接收 结 


mE 箱 可 以 看 到 了 刚才 发 送 的 邮件 ， 如 图 9-25 
ZR œ 


| «am || me | mx | mae «| 移动 到 v | mae || 展开 全 部 


来 自 Spring 的 新 闻 F 


(=) OF (Webinar Replay: A Spring Showcase: Turkcell's Personal Cloud Storage App) https://spring.io/blog/20 


(=) OF (Webinar Replay: Debug and Maintain your Spring Boot App) https://spring.io/blog/2015/07/09/webinar- 


图 9-25 ”刚才 发 送 的 邮件 


105 Spring Boot 开 发 部 署 与 测试 
10.1 开发 的 热 部 署 


10.1.1 模板 热 部 署 


在 Spring Boot 里 ， 柑 板 引擎 的 页 面 默认 是 开 
局 缓存 的 ， 如 末 修 改 了 页 面 的 内 容 ， 则 刷新 页 面 
是 得 不 到 修改 后 的 页 面 的 因此 ， 我 们 可 以 在 
application.properties FR HIER 5| BVA, W 
如 : 


Thymeleaf 的 配置 : 


spring.thymeleaf.cache-false 


FreeMarkerB fir E : 


spring.freemarker.cache-false 


Groovy 的 配置 : 


spring.groovy.template.cache-false 


Velocity 的 配置 : 


spring.velocity.cache-false 


10.1.2 Spring Loaded 


Spring Loaded 可 实现 修改 类 文件 的 热 部 署 。 
下 载 Spring Loaded， 地 址 为 : 
http://repo.spring.io/simple/libs-release- 
local/org/springframework/springloaded/1.2.3.RELE 
ASE/springloaded-1.2.3.RELEASE.jar, CE uH 
Run Config urations...。 如 图 10-1 所 示 。 


31 1Chl0Application a 


Run As 


Run Configurations... 


Organize Favorites... 


10-1 单 击 RunConfigurations 


在 Arguments 标 签 页 的 vm arguments 中 填 入 如 
下 内 容 ， 注 意 下 面 指定 的 Springloaded 的 路 径 : 


-javaagent:E:Nspringloaded-1.2.3.RELEASE.jar -noverify 


页 面 截图 如 图 10-2 所 示 。 


© Run Configurations 


Run a Java application 


Create, manage, and run configurations © 


BAXIB F” Name: Ch10Application 


© Main | 69- Arguments ~ Bi JRE | “> Classpath | By Source WS Environment ”> 
Æ AspectJ/Java Appli ^ 
€ Eclipse Application 
E3 Eclipse Data Tools 


Program arguments: 


B Generic Server 


B Generic Server(Exte TEES | 


8 HTTP Preview 


È J2EE Preview VM arguments: 
E] Java Applet -javaagent:EAspringloaded-1.2.3.RELEASE jar -noverify 


4 [3] Java Application i 
D Chi0Applicatior _| 

Ju JUnit i Variables... 
Jo JUnit Plug-in Test 
m2 Maven Build Working directory: | 
4p OSGi Framework © Default: $(workspace loc:ch10 
@ Pivotal tc Server Other: 
© Spring Boot App 

| Jy Task Context Test 

x XSL 


m 


< m D 


Filter matched 21 of 40 items ids mia i 


10-2 ”Arguments 标 签 页 


10.1.3 JRebel 


JRebel 是 Java 开 发 热 部 署 的 最 佳 工具 ， 其 对 
Spring Boot 也 提供 了 极 佳 的 支持 。JRebel 为 收费 
软件 ， 可 试用 14 天 。 


(1) 安装 
打开 EclipseMarketPlace， 如 图 10-3 所 示 。 


Run Window 
& He G ©) Dashboard 


7246 /p (2) Help Contents 
QP Search 


Dynamic Help 


Key Assist... 


Tips and Tricks... 
© Report Bug or Enhancement... 
Cheat Sheets... 


Check for Updates 
Install New Software... 


© About Spring Tool Suite 


图 10-3 ”打开 Eclipse Marketplace 


检索 JRebel， 并 安装 ， 如 图 10-4 所 示 。 


Eclipse Marketplace 


Select solutions to install. Press Finish to proceed with installation. 
Press the information button to see a detailed overview and a link to more information. 


| Search [Recent | Popular | Installed |. 0 July Newsletter| o 
maj] Ae F3 
JRebel for Eclipse 


JRebel is a productivity tool that allows you to reload changes you make to your 
code without the need to redeploy. It maps your project workspace directly to a... 


by ZeroTurnaround, Commercial 


(e) Installs: 168K (6,247 last month) 


< Back Install Now > Finish 


图 10-4 ”安装 JRebel 
重启 STS， 即 可 完成 安装 。 
(2) 配置 使 用 
注册 试用 ， 如 图 10-5 所 示 。 


o JRebel Activation Details A x 


Try JRebel for FREE | I already have a license | 


Get started with a free 14-day JRebel Trial. 


First name jE 


Last name zz E 


Email wisely-man@126.com 


Phone 15222222222 
Company 合肥 


I agree with the terms & conditions of the JRebel License Agreement 


| Activate JRebel 


图 10-5 ”注册 


 XexESpring Boot， 增 加 JRebel 功 能 ， 如 图 10-6 
所 示 。 


eS chin. 
New 


Go Into 


Open in New Window 
Open Type Hierarchy 
Show In 


Copy 
Copy Qualified Name 
Paste 


Delete 


Remove from Context 
Build Path 
Source 


Refactor 


Import... 
Export... 


Refresh 

Close Project 

Close Unrelated Projects 
Assign Working Sets... 


Run As 

Debug As 
Profile As 
Validate 
Restore from Local History... 
JRebel 

Maven 

Team 

GitHub 
Compare With 
Configure 
Spring Tools 


Properties 


F4 
Alt+Shift+W > 


Ctrl+C 


Ctrl+V 
Delete 


Ctrl+Alt+Shift+Down 
> 
Alt+Shift+S » 
Alt+Shift+T » 


> Q Add JRebel Nature | 


b 


b 
» 


b 


Alt+Enter 


图 10-6 


此 时 为 我 们 添加 了 一 个 rebel.xml， 用 来 配置 


增加 JRebel 功 能 


热 部 署 内 容 ， 如 图 10-7 所 示 。 


a (C3 ch10) 
> @ src/main/java 
4 (SE src/main/resources 
& static 
=> templates 


f? application.properties 


X) rebel.xml 


4 (9. src/test/Java 
> 83 com.wisely.ch10 
> mà JRE System Library UavaSE-1.8) 
> mà Maven Dependencies 
> » src 
& target 
Im] pom.xml 


10-7 ”增加 的 rebcl.xml 


JRebel 会 对 D: /workspace-sts- 
3.7.0.RELEASE/ch10/target/classes 目 录 下 的 文件 进 
行 热 部 署 ， 如 图 10-8 所 示 。 


X) rebel.xml 23 


k?xml version="1.@" encoding="UTF-8"?> 
><application xmlns:xsis-"http://www.w3.0rg/2001/XMLSchema-instance" xmlns="htt, 


S <classpath> 
= «dir name="D:/workspace-sts-3.7.0.RELEASE/ch10/target/classes"> 
</dir> 
</classpath> 


</application> 


图 10-8 对 文件 进行 热 部 署 


首次 启动 会 询问 是 否 以 JRebel 启 动 程序 ， 如 
图 10-9 所 示 。 


o Launch with JRebel? esm] 


Eò You are launching a JRebel-enabled application without the JRebel agent. 
” JRebel will not work without it. 


Launch with JRebel agent Not this time 


图 10-9 询问 是 否 以 JRebel 有 启动 程序 


当局 动 时 出 瑰 和 JRebel 相 关 的 信息 ， 表 明 配 
置 成 功 ， 如 图 10-10 所 示 。 


beis-e7-3e 22:32:18 JRebel: 

2015-07-30 22:32:18 JRebel: 

2015-07-30 :32: JRebel: 

2015-07-30 :32: JRebel: JRebel Legacy Agent 6.2.2 (201507291221) 

2015-07-30 22:32:18 JRebel: (c) Copyright ZeroTurnaround AS, Estonia, Tartu. 

2015-07-30 22:32:18 JRebel: 

2015-07-30 :32: JRebel: Over the last 1 days JRebel prevented 

2015-07-30 22:32:18 JRebel: at least @ redeploys/restarts saving you about 9 hours. 
2015-07-30 22:32:18 JRebel: 

2015-07-30 £32: JRebel: Licensed to iz X 

2015-07-30 :32: JRebel: 

2015-07-30 22:32:18 JRebel: License type: evaluation 

2015-07-30 :32: JRebel: Valid from: July 30, 2015 

2015-07-30 :32: JRebel: Valid until: August 13, 2015 

2015-07-30 22:32: JRebel: 

2015-07-30 22:32:18 JRebel: You are using an EVALUATION license. 

2015-07-30 332: JRebel: Days left until license expires: 14 

2015-07-30 22:32:18 JRebel: 

2015-07-30 22:32:18 JRebel: To extend your evaluation or purchase a license, 

2015-07-30 22:32:18 JRebel: contact sales(izeroturnaround.com. 

2015-07-30 :32: JRebel: 

2015-07-30 22:32:18 JRebel: If you think this is an error, contact support@zeroturnaround.com. 
2015-07-30 232: JRebel: 

2015-07-30 22:32:18 JRebel: 

2015-07-30 22:32: JRebel: 

2015-07-30 22:32:18 JRebel: 

2015-07-30 22:32: JRebel: Directory ‘D:\workspace-sts-3.7.@.RELEASE\ch1@\target\classes’ will be monitored for changes. 
2015-07-30 22:32: JRebel: Monitoring resource 'D:\workspace-sts-3.7.@.RELEASE\ch10\target\classes\application.properties’. 


YN 
m d AO TN WAN 
34 lebt 5») 
MEA rl 


£347 
1.3.0.M2) 


图 10-10 ”启动 成 功 
10.1.4 Spring-boot-devtools 


在 Spring Boot 项 目 中 添加 spring-boot-devtools 
依赖 即 可 实现 页 面 ， 即 代码 的 热 部 署 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-devtools</artifactId> 
</dependency> 


10.2 T RAR 
10.2.1 ja 形式 


1. 打 包 


若 我 们 在 新 建 Spring Boot 项 目的 时 候 ， 选 择 
打包 方式 (Packaging) 是 jar， 则 我 们 只 需 用 : 


mvn pakage 


如 图 10-11 所 示 ° 


| E 管理 员 : C:\Windows\system32\cmd.exe ee E el Tum = 
Microsoft Windows [版 本 6.1.7601] 
版 权 所 有 (c) 2009 Microsoft Corporation. (RE PU ALF. 


C:\Users\wisely>cd D:\workspace-sts-3.7.0.RELEASE\ch10 
C:\Users\wisely>d: 


D: \workspace-sts-3.7.0.RELEASE\ch10>mun package 
[INFO] Scanning for projects... 


--- mauen-resources-plugin:2.6:resources (default-resources) 8 chlO --- 
Using 'UTF-8' encoding to copy filtered resources. 

Copying 1 resource 

Copying 1 resource 


Egi SER: CAWindowslsystem32Vomd exe ā— 


2015-07-30 23 
2015-07-30 23 
2015-07-39 23 
Tests run: 1, 
2015-07-30 23 


12:50.166 
12:50.195 
:12:50. 362 
Failures 
12:50.377 


INFO 
INFO 
INFO 
0, Errors 
INFO 


Results 


Tests run: 1, Failures; 0, Errors 
[ INFO] 
[ INFO] 
[ INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[ INFO] 
[INFO] 


Building jar | D: XVworkspace- 


BUILD 


SUCCESS 


Total time: 
Finished at: 


Final Memory: 29M/216M 


8, 


7088 --- [ 
7000 --- [ 
7000 --- [ 
Ə 
7000 --- [ 


e 
E 


kipped: 0, Time elapsed: 2.005 sec - in com.wisely.ch 


Skipped: O 
--- mauen-jar-plugin:2.5:jar (default-jar) 8 ch18 
3.T.8.RELERSEXchTONEargetVchT18-8.8.1-SNAPSHOT. jar 


--- spring-boot-imauen-plugin:1.3.0.M2:repackage (default) 8 ch16 --- 


2015-07-30T23:12:594*08: 


main] o.s.W.s.handler.SimpleUrlHandlerMapm 
main] o.s.w.s.handler.SimpleUrlHandlerMap| 
main] com.wisely.chi0.ChiOApplicationTest 


Thread-2] 0.5.w.c.s.GenericllebüpplicationCont 


target » 


» workspace-sts-3.7.0.RELEASE » chl0 » 
RH) 

新 建文 件 夫 

ER 

更 classes 

di generated-sources 

出 generated-test-scurces 

dt maven-archiver 

J| maven-status 

d surefire-reports 

| test-classes 

国 ch10-0.0.1-SNAPSHOT 

|_| ch10-0.0.1-SNAPSHOT jer.original 


图 10-11 


\ 一 ”人 一 … 


2.38 


í 


可 直接 使 用 下 面 
ZN ° 


java -jar xx.jar 


A 
HH 


\ 一 /一 


和 运作 mvn pakage 


今 


N 


运 


ZC— 


结果 如 图 10-12 所 


Ug ERA CAWindows\system32\cmd.exe - java -jar ch10-0.0.1-SNAPSHOT jar è LJ = = ox 


O. RELEASE 


6. RELEASE 


ch10.ChlORpplication Starting 


main] ationConfigEmbeddedWebáp, 
51 


sain] s.b $.DefaultListab 


prim f epringframeuork .boot .au re .web 
boot »configure/web/ErrorMucRutoC i sti ] ebelErrorUiewConfiguration > with [Root bean 
Autol 9 ion$WebMucRutoConfig )ryMet lame-beanNameUiewResoluer: initMethodName 
49.0 . ir > AA beddedSeruletContainer 
spache. catalina.core.StandardServi 
apache. catalina.core. StandardEn¢ ting 


[Tomca [1ocalhost] 


itextLoader Root WebA 
92015 3 @.ServiletRegistra n Mapping 
2 artStop-1 .上 embedded 


tartStop-1 embedded 
startStop c. embedded E Mapping 


RequestMappingHandlerüdapter Looking 


658 INFO 655 pain) 6.0.9 uestMappingHandlerMapping : Mapped 
50.660 ( -- ] 9.4.5 RequestMappingHandlerMapping : Mapped 
SeruletRe 


58.661 INF E = $5 > 2.8.RequestMappingHandlerMapping Mapped 


main handler .SimpleUrlHandlerMapping Mapped URI 
main handler pleUrlHandlerMapping Mapped URI 
main] 3. handler .SimpleUrlHandlerMappin: Mapped URI 
main] J a.Annotati anExpor ter Registeri 
main) TomcatEabeddedServletContainer 


t 
ch Chi Applicat: 1c 


10-12 ”运行 java-jar xx.jarfig 4» 


3.1379] 73 Linux BJ B 2$ 


Linux PIS {TA eX Pel D83 58 Tt CIENIA B 
25, AERIS Low fS 7T J6 ^ XB AKA 
持 开 机 局 动 等 功能 。 


右 想 使 用 此 项 功能 ， 我 们 需 将 代码 中 关于 
spring-boot-maven-plugin 的 配置 修改 为 : 


«build» 
«plugins» 
«plugin» 
«groupId»org.springframework.boot«/groupId-» 


<artifactId>spring-boot-maven- 
plugin</artifactId> 
<configuration> 
<executable>true</executable> 
</configuration> 
</plugin> 
</plugins> 
</build> 


然后 使 用 mvn package 打 包 。 


主流 的 Linux 大 多 使 用 init.d 或 systemd 来 注册 
服务 。 下 面 以 CentOS 6.6 演 示 init.d 注 册 服 务 ， 以 
CentOS 7.1 演 示 systemd 注 册 服 务 。 探 作 系 统 可 选 
PE (8 FA VirtualBox 2B BREEN LAR Le © 


用 SSH 窜 户 端 将 jar 包 上 传 到 CentOS 的 /vavapps 
下 [9] 


(1) 安装 JDK 
从 Oracle 官 网 下 载 JDK， 注 意 选 择 的 是 : jdk- 
8u51-linux-x64.rpm ° 这 是 红 帽 系 Linux 系 统 专 用 安 
淡 包 格式 ， 将 JDK 下 载 放 置 到 Linux 下 任意 目录 。 
执行 下 面 命 令 安装 JDK: 


rpm -ivh jdk-8u51-linux-x64.rpm 


(2) 基于 Linux 的 init.d 部 署 


注册 服务 ， 在 CentOS 6.6 的 终端 执行 : 


sudo ln -s /var/apps/ch10-0.0.1-SNAPSHOT.jar 
/etc/init.d/ch10 


其 中 ch10 吏 是 我 们 的 服务 名 。 
局 动 服务 : 
service ch10 start 
停止 服务 : 
service ch10 stop 
服务 状态 : 
service ch10 status 


开机 局 动 : 


chkconfig ch10 on 


项 目 日 志 存 放 于 /var/log/ch10.log 下 ， 可 用 cat 


或 tail 等 命令 查看 。 


(3) 基于 Linux 的 Systemd 部 署 


在 /etc/systemd/systemy/ 目 孙 下 新 建文 件 
ch10.service, IBA HINA: 


[Unit] 

Description=ch1i0 

After=syslog.target 

[Service ] 

ExecStart= /usr/bin/java -jar /var/apps/ch10-0.0.1- 
SNAPSHOT. jar 


[Install] 
WantedBy=multi-user.target 


注意 ， 在 实际 使 用 中 修改 Description 和 
ExecStart 后 面 的 内 容 。 


局 动 服务 : 


systemctl start ch10 
Bysystemctl start chi10.service 


停止 服务 : 


systemctl stop ch10 
8ysystemctl stop chi0.service 


服务 状态 : 


systemctl status ch10 
BSysystemctl status chi0.service 


开机 局 动 : 


systemctl enable ch10 
或 systemct1 enbale chi0.service 


项 目 日 志 : 


journalctl -u ch10 
或 journalct1 -u chi@.service 


10.2.2 war 形式 


1. 打 包 方 式 为 war 时 


STE Spring Boot 项 目 时 可 选择 打包 方式 
(Packaging) 是 war 形 式 ， 如 图 10-13 所 示 。 


c — 一 


New Spring Starter Project r^ 一 
L4 7 
Nam ch10v 
v) Use default location 
ace-sts 
Typ | Maven Project v Packaging: Wi | 


图 10-13 ”选择 打包 方式 为 war 


打包 的 方式 和 jar 包 一 致 ， 执 行 : 


mvn package 


结果 如 图 10-14 所 示 。 


5) » workspace-sts-3.7.0.RELEASE » chiOwar » target > 
RH) 
新 建文 件 夫 J=- | 
名 称 E 修改 日 期 aem 大 
J|. chiOwar-0.0.1-SNAPSHOT 0 BE 文件 去 
Ù cla 0 S55 文件 去 
J genera ted-sources 0 星期 Xx 
J| generated-test 0 SER vk 
Ji m2e-wtp 0 ERR 文 
dJ mav h 0 SRR 文件 去 
J maven-status 0 ERR Xx 
| surefire-reports EE 文件 去 
test-cl ) 星期 XX 
|_| chiOwar-0.0.1-SNAPSHOT.war 2015 ) 星期 AR X 
|_| ch10war-0.0.1-SNAPSHOT.war.original 2015/7/30 E& RIGINAL 文件 


图 10-14 打包 结果 


最 后 生成 的 war 文 件 可 以 放 在 你 喜欢 的 Servlet 
容器 上 运行 。 


2.4) 8,71 3&2 jar] 


E RKI BTE Spring Boot 项 目 时 选择 打包 方式 
选择 的 是 jar， 部 署 时 我 们 又 想 要 用 war 包 形式 部 
署 ， 那 么 怎么 将 jar 形 式 转 换 成 war 形 式 呢 ? 当然 需 

SK ACW 2E xe — FER © 


我 们 比较 下 jar 打 包 和 war 打 包 项 目 文件 的 不 同 
之 处 ， 即 可 知 做 如 下 修改 可 将 jar 打 包 方 式 转换 成 
war 打 包 方 式 。 


在 pom.xml 文 件 中 ， 将 


<packaging>jar</packaging> 


修改 为 


<packaging>war</packaging> 


ETE P TA FACRIS ms ERA N EJ Tomcat fl : 


<dependency> 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter- 
tomcat</artifactId> 
<scope>provided</scope> 
</dependency> 


增加 ServletInitializer 类 ， 内 容 如 下 : 


import 
org.springframework.boot.builder.SpringApplicationBuilder; 
import 
org.springframework.boot.context.web.SpringBootServletInitia 
lizer; 


public class ServletInitializer extends 
SpringBootServletInitializer { 


QOverride 


protected SpringApplicationBuilder 
configure(SpringApplicationBuilder application) { 
return 
application.sources(Chi0warApplication.class); 


10.3. zB E —3 T Docker Ab E 


本 节 我 们 将 在 CentOS 7.1 上 演示 用 Docker 部 
3E Spring Boot 程 序 。 前 面 我 们 讲述 了 使 用 已 经 编 
译 好 的 Docker 镜 像 ， 本 区 我 们 将 讲述 如 何 编译 目 
CW) DockertR 1, JFIATT ERR A ae 

主流 的 云 计算 (PAAS) 平台 都 支持 发 布 
Docker 镜 像 。Docker 是 使 用 Dokerfile 文 件 来 编译 
目 己 的 镜像 的 。 


10.3.1 Dockerfile 


Dockerfile 主 要 有 如 下 的 指令 。 
(1) FROM 指令 


FROM 指令 指明 了 当前 镜像 继承 的 基 镜 像 。 
编 详 当前 镜像 时 会 目 动 下 载 基 镜像 。 


示例 : 


FROM Ubuntu 


(2) MAINTAINER 指 令 
MAINTAINER 指 令 指明 了 当前 镜像 的 作者 。 
示例 : 

MAINTAINER wyf —— — 

(3 RUN 指 令 
RUN 指 令 可 以 在 当前 镜像 上 执行 Linux 命 令 并 

ee 


示例 可 有 如 下 两 种 格式 ，CMD 和 
ENTRYPOINT 也 是 如 此 : 


RUN /bin/bash -c "echo helloworld" 
或 RUN ["/bin/bash", "-c", "echo hello"] 


(4) CMD 指 令 


CMD 指 令 指 明了 启动 镜像 容器 时 的 默认 行 
为 。 一 个 Dockerfile 里 只 能 有 一 个 CMD 指 令 。 


CMD 指 令 里 设 定 的 命令 可 以 在 运行 镜像 时 使 用 参 
TUB CMDzE[(THh] (ru) 的 动作 。 


示例 : 


CMD echo "this is a test" 


n] @¥docker run-d image name echo"this is not 
a test 4E nz. ° 


(5 EXPOSE 指 令 


EXPOSE 指 明了 镜像 运行 时 的 容器 必需 监听 
指定 的 端口 。 


示例 : 
EXPOSE 8080 
(6) ENV 指 令 
ENV 指 令 可 用 来 设置 环境 变量 。 
示例 : 


ENV myName-wyf 
或 ENV myName wyf 


(7) ADD 指 令 


ADD 指 令 征 从 当前 工作 目 永 复制 文件 到 镜像 
Eee 


示例 : 
ADD test.txt /mydir/ 
(8) ENTRYPOINT 指 令 
ENTRYPOINT 指 令 可 让 容 融和 像 一 个 可 执行 程 
序 一 样 运行 ， 这 样 镜像 运行 时 可 以 像 软件 一 样 接 
收 参 数 执行 。ENTRYPOINT 是 运行 时 (run) 的 动 


o 


示例 : 


ENTRYPOINT ["/bin/echo"] 


RATA VATE BEER Te IRE 390217: 


docker run -d image name "this is not a test" 


10.3.2 ZcXéDocker 


通过 下 面 命令 安 妆 Docker: 
yum install docker 


局 动 Docker 并 保持 开机 目 局 : 


systemctl start docker 
systemctl enable docker 


10.3.3 JH RRR 


我 们 使 用 源码 的 ch10docker 来 作为 演示 用 的 
Spring Boot 项 目 ， 这 个 项 目 很 浴 单 ， 只 修改 了 入 
口 类 ， 代 码 如 下 : 


@SpringBootApplication 
QRestController 
public class Chi0dockerApplication { 
QRequestMapping("/") 
public String home() { 
return "Hello Docker!!"; 


public static void main(String[] args) { 
SpringApplication.run(Chi10dockerApplication.class, 
args); 


j 


在 CentOS 7.1 F-Éj/var/apps/ch10docker H 5& F 
放 入 我 们 编译 好 的 ch10docker 的 jar 包 ， 如 


ch10docker-0.0.1-SNAPSHOTjar， 在 同 级 目录 下 
3ri— "^T Dokcerfile X ff: ° 


文件 目 孙 如 图 10-15 所 示 。 


[rootGMiwiF1-R1LD chiOdocker]# cd /var/apps/chi0docker / 
OQOT0Mi i 1 z D n16nu20 a ~ 


hi0docker 0. 0. 1-SNAPSHOT. jar Dockerfile 
OU LG. TW =RID OUUCKe - 


图 10-15 ”文件 目录 
Dockerfile 文 件 内 容 如 下 : 


FROM java:8 

MAINTAINER wyf 

ADD chiO0docker-0.0.1-SNAPSHOT.jar app.jar 
EXPOSE 8080 


ENTRYPOINT ["java", "-jar", "/app. jar"] 
代码 解释 

中 基 镜 像 为 Java， 标 签 (版 本 ) 为 8。 
@ 作 者 为 wyf ° 


(3 将 我 们 的 ch10docker-0.0.1-SNAPSHOT.jar 
添加 a 到 镜像 中 ， 并 重 命 名 为 app.jar ° 


由 运行 镜像 的 容器 ， 监 听 8080 端 口 。 
局 动 时 运行 java-jar app.jar ° 

10.3.4 ”编译 镜像 
在 /varvapps/ch10docker 目 孙 下 执行 下 面 命 


令 ， 执 行 编 详 镜像 : 


docker build -t wisely/chi0docker . 


其 中 ，wiselych10docker 为 镜像 名 称 ， 我 们 设 
置 wisely 作 为 前 缀 ， 这 也 是 Docker 镜 像 的 一 种 命名 
习惯 。 

注意 ， 节 后 还 有 一 个 “”， 这 是 用 来 指明 
Dockerfile 路 径 的 ,“.” 表 示 Dockerfile 在 当前 路 径 
下 o 


编译 的 过 程 如 图 10-16 所 示 。 


sending Build context to Docker daemon 12.98 MB 
Sending build context to Docker daemon 
step 0 : FROM java:8 
Trying to pull Wa dap docker.io/java ... 
49ebfec495e1: ng image (8) from docker.io/java, endpoint: https://registry- 
49ebfec495el: Download complete 
902b87aaaec9: Download complete 

: Download complete 

: Download complete 

: Download complete 

: Download complete 

: Download complete 

: Download complete 

: Download complete 
93934clael9e: Download complete 
2262501f7b5a: Download complete 
bfb63bOf4dbi: Download complete 
Status: Downloaded newer image for docker.io/java:8 
---» 49ebfec495e1 


Step 1 : MAINTAINER yid 

---» Running in 7534b74750ae 

---» 38729c353a8a 

Removing intermediate container 7534b74750ae 
Step 2 : ADD chiOdocker-0.0.1-SNAPSHOT.jar app.jar 
---» Of51ff5e661d 

Removing intermediate container ci8eedeOb8f8 
Step 3 : EXPOSE 8080 

---> Raning Ba m pem 

---> 7845fe325e 

Removing Se container 19bd1a783f27 
Step 4 : ENTRYPOINT java -jar /app.jar 

---» Running in d912eci29ac3 

---> 4571ea4b04d3 

Removing intermediate container d912ec129ac3 
Successfully built 4571ea4b04d3 


图 10-16 ”编译 过 程 
这 时 我 们 查看 本 地 人 说 像 ， 如 图 10-17 所 示 。 


rootéMiwiFi-R1D chl0dockerj# docker images 


REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 
wisely/chiOdocker latest 4571ea4b04d3 4 minutes ago 829.3 M 
docker.io/java 8 49ebfec495el1 2 weeks ago 816.4 MB 


图 10-17 本 地 镜像 


通过 下 面 命令 运行 : 


docker run -d --name ch10 -p 8080:8080 wisely/chi0docker 


得 看 我 们 当前 的 容 夯 状态， 如 图 10-18 所 示 。 


[rootewiwirFi-RID chiOdocker]@ docker ps | 
ICONTAINER ID IMAGE 
80138di6d9ef i: 


COMMAND CREATED STATUS — PORTS NAMES 
“java -jar /app.jar" 3 minutes ago Up 3 minutes 0.0.0. 0:8080-»8080/tc| chio 


10-18 当前 容器 状态 


当前 的 CentOS 系 统 的 ip 为 192.168.31.171， 访 
问 http:/192.168.31.171: 8008， 我 们 可 以 看 到 如 
图 10-19 所 示 页 面 。 


4 @ 192.168.31.171:8080 


€ Q | O 192.168.31.171:8080 


Hello Docker!! 


图 10-19  mkHello Docker! |! 


10.4 Spring Boot 的 测试 


Spring Boot 的 测试 和 Spring MVC 的 测试 类 
似 。Spring Boot 为 我 们 提供 了 一 个 
@SpringApplicationConfiguration 来 蔡 代 
@ContextConfiguration， 用 来 配置 Application 
Context ° 


在 Spring Boot, FARIEM HAIR, Ab 
会 目 动 加 上 spring-boot-starter-test 的 依赖 ， 这 样 我 
们 束 没 有 必要 测试 时 再 添加 和 额外 的 jar 包 。 


Spring Boot 还 会 建 一 个 当前 项 目的 测试 类 ， 
位 于 src/test/java 的 根 包 下 。 


本 太 我 们 将 直接 演示 一 个 人 简 竺 的 测试 ， 测 试 
菜 一 个 控制 右 方 法 古人 盏 满足 测试 用 例 。 


10.4.1 新 建 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA (spring- 
boot-starter-data-jpa) ^ Web (spring-boot-starter- 


web) 、hsqldb 《内 存 数 据 库 ) ° 
项 目 信息 : 


groupId: com.wisely 
arctifactId:chi10 4 
package: com.wisely.ch10 4 


10.4.2 ”业务 代码 


实体 关 : 


package com.wisely.ch10 4.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 

public class Person ( 
@Id 
@GeneratedValue 
private Long id; 
private String name; 


public Person() { 
super(); 


public Person(String name) { 
super(); 
this.name = name; 


j 
public Long getId() ( 
return id; 


public void setId(Long id) { 


this.id = id; 

} 

public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


j 


数据 访问 : 


package com.wisely.ch10_4.dao; 


import 
org.springframework.data.jpa.repository.JpaRepository; 


import com.wisely.chi10 4.domain.Person; 


public interface PersonRepository extends 
JpaRepository«Person, Long» ( 


j 


PE BIAN: 


package com.wisely.ch10_4.web; 
import java.util.List; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.http.MediaType; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RequestMethod; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.chi0_4.dao.PersonRepository; 
import com.wisely.chi10 4.domain.Person; 


QRestController 
QRequestMapping("/person") 
public class PersonController { 
@Autowired 
PersonRepository personRepository; 


@RequestMapping(method = RequestMethod.GET, produces = 
{MediaType.APPLICATION_JSON_VALUE} ) 
public List<Person> findAll()( 
return personRepository.findAll(); 
} 


10.4.3 ”测试 用 例 


package com.wisely.ch10 4; 


import org.junit.Assert; 

import org.junit.Before; 

import org.junit.Test; 

import org.junit.runner.RunWith; 

import 
org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.boot.test.SpringApplicationConfiguration 


T 

import org.springframework.http.MediaType; 

import 
org.springframework.test.context.junit4.SpringJUnit4ClassRun 
ner; 

import 
org.springframework.test.context.web.WebAppConfiguration; 
import org.springframework.test.web.servlet.MockMvc; 

import org.springframework.test.web.servlet.MvcResult; 
import 


org.springframework.test.web.servlet.request.MockMvcRequestB 
uilders; 

import 
org.springframework.test.web.servlet.setup.MockMvcBuilders; 
import 
org.springframework.transaction.annotation.Transactional; 
import 
org.springframework.web.context.WebApplicationContext; 


import com.fasterxml.jackson.core.JsonProcessingException; 
import com.fasterxml.jackson.databind.ObjectMapper; 

import com.wisely.chi10 4.dao.PersonRepository; 

import com.wisely.chi10 4.domain.Person; 


QRunWith(SpringJUnit4ClassRunner.class) 
QSpringApplicationConfiguration(classes - 
Chi04Application.class) //1 
@WebAppConfiguration 
@Transactional //2 
public class Chi04ApplicationTests { 
@Autowired 
PersonRepository personRepository; 


MockMvc mvc; 


@Autowired 
WebApplicationContext webApplicationContext; 


String expectedJson; 


@Before //3 

public void setUp() throws JsonProcessingException{ 
Person pi = new Person("wyf"); 
Person p2 = new Person('wisely"); 
personRepository.save(p1); 
personRepository.save(p2); 


expectedJson -0bj2Json(personRepository.findAll()); 
//4 

mvc = 
MockMvcBuilders.webAppContextSetup(webApplicationContext).bu 
ild(); 


protected String Obj2Json(Object obj) throws 
JsonProcessingException{//5 
ObjectMapper mapper = new ObjectMapper(); 
return mapper .writeValueAsString(obj); 


} 


@Test 
public void testPersonController() throws Exception { 
String uri="/person"; 
MvcResult result = 
mvc.perform(MockMvcRequestBuilders.get(uri).accept (MediaType 
. APPLICATION_JSON) ) 


.andReturn(); //6 
int status = result.getResponse().getStatus(); //7 
String content = 
result.getResponse().getContentAsString(); //8 


Assert.assertEquals ("错误 ， 正 确 的 返回 值 为 200", 200, 
status); //9 

Assert.assertEquals("faik, 返回 值 和 预期 返回 值 不 一 致 "， 
expectedJson,content); //10 


j 


代码 解释 


OIE FA @SpringA pplicationConfiguration1¢ 
(D ContextConfiguration2K Ac & Spring Boot 
Application Context ° 


GO) 使 用 @Transactional 注 解 ， 确 保 每 次 测试 后 
的 数据 将 会 被 回 滚 。 


(3) 使 用 Junit 的 @Before 注 解 可 在 测试 开始 前 进 
行 一 些 初始 化 的 工作 。 


由 获得 期 竺 返回 的 JSON 字 符 串 。 
二 将 对 象 转换 成 JSON 字 符 串 。 

(9) 获 得 一 个 request 的 执行 结果 。 

(7 获得 request 执 行 结 果 的 状态 

(8) 获 得 request 执 行 结 果 的 内 容 。 

9) 将 预期 状态 200 和 实际 状态 比较 。 
d0 将 预期 字符 串 和 返回 字符 串 比 较 。 


10.4.4 ”执行 测试 


我 们 可 以 使 用 maven 命 令 执行 测试 : 
mvn clean package 


结果 如 图 10-20 所 示 。 


图 10-20 测试 结果 


我 们 还 可 以 在 STS 直 接 使 用 Run As > JUnit 
Test， 允 有 果 如 图 10-21 所 示 。 


属 Spring Explorer 4 Debug rjv JUnit 23 a? 41 58 | Q, A + 
Finished after 6.256 seconds 


Runs: 1/1 — BEmos O Failures: O M 


v HE com.wisely.ch10 4.Ch104ApplicationTests | = Failure Trace 2d 
£k] testPersonController (0.404 s) 


图 10-21 直接 使 用 RunAs > Junit Test 


11% MHIE 


Spring Boot 近 做 了 运行 时 的 应 用 监控 和 管理 
的 功能 。 我 们 可 以 通过 http、JMX、SSH 协 议 来 进 
行 控 作 。 审 计 、 健 康 及 指标 信息 将 会 目 动 得 到 。 

Spring Boot 提 供 了 监控 和 管理 端点 ， 如 表 11- 
LTA ° 


表 11-1 监控 和 管理 端点 


端点 名 描 R 
actuator 所 有 EndPoint 的 列表 ， 需 加 入 spring HATEOAS 支持 
autoconfig 当前 应 用 的 所 有 自动 配置 
beans 当前 应 用 中 所 有 Bean 的 信息 
configprops 当前 应 用 中 所 有 的 配置 属性 
dump 显示 当前 应 用 线程 状态 信息 
env 下 当前 应 月 息 
health 下 当前 应 用 健 
info 显示 当前 应 用 信息 
metrics 显示 当前 应 用 的 各 项 指标 信息 
mappings 显示 所 有 的 @RequestMapping 映射 的 路 径 
shutdown 关闭 当前 应 用 (默认 关闭 ) 


trace 显示 追踪 信息 ( 默认 最 新 的 http 请 求 ) 


11.1 http 


我 们 可 以 通过 http 实 现 对 应 用 的 监控 和 管理 ， 我 
们 只 需 在 pom.xml 中 增加 下 面 依赖 即 可 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter - 
actuator</artifactId> 
</dependency> 


PLA TOES hp PRU 理 ， 那 么 我 们 的 项 目 中 必 
然 需要 Web 的 依赖 。 本 世 需 新 建 Spring Boot 项 目 ， 依 
EMEEN: Actuator ` Web ` HATEOAS ° 


11.1.1 新 建 Spring Boot™ H 


新 建 Spring Boot ™ H, WEA Actuator (spring- 
boot-starter-actuator) ` Web (spring-boot-starter- 
web) ^ HATEOAS (spring-hateoas) ° 


项 H fs A: 


groupId: com.wisely 
arctifactId:chi1 1 
package: com.wisely. chi1 1 


11.1.2. ”测试 端点 


项 目 建 立 好 之 后 我 们 即 可 测试 各 个 端点 。 


(1) actuator 


访问 http://localhost: 8080/actuator， 歼 果 如 图 11- 
1 所 示 。 


图 11-1 访问 actuator 


(2) autoconfig 


V;lH]http://localhost: 8080/autoconfig, ® oA 
11-2 所 示 。 


j @ localhost 8080/autocor x \ 
€ > Q fi 5localhost8080/autoconfig 


t 7m ^ i 
“positiwllatches” 上 : fal B 
"huditAut Configuration. AÁuditEventRepositorYConfigursticn" [ 
1 
“condition” — "OnBeanCondition", 
"message ^ "ADConditionalOnMi ssingRean (types 
org. springt ranework, boot. sctuste. midit. AuditEventRepository; SearchStratecy: all) found no beans” 
! 
1. 
"EndpointAutoConfigurationfmutoConfiguratiorReportEndpoint:/ [ 
I 
“condition”. "OnBeanCondilion', 
"mestnpe"/— "SConditionalóeReman (types 
org. springframework. boot. mutoconfigure. condition ConditionÉvalustiorReport, SearchStrategy, all) found the 
following [autoConfigurationReport) éConditionalOnMirringBesn (types 
org. sprangt ame work. boot, actuate. endpoant. AuLcConfigurataonkeportlndpoint, SearchsStratevy. current) found 
no bem" 
1 
l. 
"Endpoint AutoConf sgur stiorffbesnsErnlpoint [ 
1 
“condition”: "OnBesnCondition', 
"misge. üLonditionalUuhssangBean (types. org. pring framework, bout. actuate. exdpount, Beanz&ralyo uit 
SenrehStrategy all) found no bears” 
1 
1 
"Endpoant AutoConf agur at 1orffcord agurationfiopertiesieporiEndpount — Í 
1 


图 11-2 ”访问 autoconfig 
(3) beans 


访问 http:Wlocalhost: 8080/beans， 歼 果 如 图 11-3 
所 示 。 


@ localhost BOBO/bears x 
€ > QC fi D localhost:8080/beans 


“dean”: "demoípplication', 

“scope”. “singleton”. 

“type”: "com. wisely. 0h12, 1. Demntpplicationf$Enhnneer bySprirqCoL18$$e 4383745" , 
"resource": “null”, 


"dependencies". O 


"bem". “org. springframevork. boot. mutoconf igure. PropertyTlaceholderAutoConfiguration", 

“scope”: “singleton”. 

“type”. “ory. s ps angel ramevork. boot. sutocont agure, Proper tyPlaceholderAut oConfa curata on$$ Enhancer By Spr ui OGL 
THES! 3503633", 

“resource”: “null”, 

"dependencies". N 


“org. springf ramework. boot. sutoconf igure. condition DeanTypeBegistry", 
^sinpleton', 
“org. sper angf rasework. boot. autoconf igure. condit von, Bean TypeRe gast ry pt imisesie sn TypeRegistey^, 
“resource”: "mull", 


图 11-3 ”访问 beans 
(4) dump 


访问 http://localhost: 8080/dump， 歼 果 如 图 11-4 
所 示 。 


@ localhost:8080/dump x 


e C fi localhost:8080/dump 


"threadName":  "http-nio-8080-exec-3", 


"methodName": “dumpThreads0”, 
"fileName mil, 

"lineNunber x 

“className”: “sun. managzement.ThreadImpl", 
"nativeMethod": true 


ioi ": "dumpàllThreads", 
mill, 


et" ch 
e”: "sun management. ThreadImpl", 
se 


图 11-4 访问 beans 
(5) configprops 


访问 http:Wlocalhost: 8080/configprops, XX^RZ Ed 
11-5 所 示 。 


(6) health 


访问 http://localhost: 8080health， 效 果 如 图 11-6 
所 示 。 


(7) info 


访问 http://localhost: 8080/info， 歼 果 如 图 11-7 所 
ZJN [o] 


a localhost:8080/configp: X \ 


€ > C fi |D localhost:8080/configprops 
1 


“links”: [ 
{ 
“rel”; “self”. 
“href”: “http: //localhost: 8080/configprops” 
H 

1, 

“management. health status.CONFIGURATION PROPERTIES': { 
“prefix”: “management. health. status”, 
"properties". { 

“order”: null 
i 

Lh 

"metricsEndpoint". | 
“prefix”: “endpoints.metrics”, 
"properties": { 

“id”: “metrics”, 

"sensitive": true, 

“enabled”: true 
H 

) 

"endpoints. cors. CONFIGURATION PROPERTIES': 
"prefix": “endpoints. cors”, 
"properties": { 

“allowe@rigins”: 
^maxàge": 1800, 
"exposedHeaders": 
“allowedHeaders”: 
"allowedlethods" 


图 11-5 ”访问 ConfigProps 


“threshold”: 10485760 


M 
“links”: [ 
{ 
“rel”: "self", 
“href”: “http: // localhost: 8080/health" 


图 11-6 ”访问 health 


1 E NM M 


“links”: [ 
{ 


“rel”: “self”, 
“href”: “http: // localhost: 8080/info" 


图 11-7 访问 info 
(8) metrics 


访问 http://localhost: 8080/metrics， 歼 果 如 图 11-8 
所 示 。 


g localhost:8080/metrics x 


€ C fi localhost:8080/metrics 


{ 
"links" [ 
{ 
"rel': "self", 
"href": “http://localhost: 8080/metrics" 
} 


Parsed 


l. 
“men” 173568, 

“nem free": 61266, 
“processors: 4 
“instance.uptime”: 262047, 
"wptime": 265121, 
"systemload.average": -l, 
"heap. committed”: 173568, 
"heap.init': 129024, 
"heap.used': 112301, 

“heap”: 1835008. 

“threads. peak”: 18. 
“threads. daemon”: 16, 
"threads": 18, 

"classes": 5928, 

“classes. loaded”: 5928, 
“classes. mloaded”: 0 
"gc.ps scavenge.count": 6 
"gc.ps scavenge.time": 56, 
"gc.ps marksweep. count" | 
"gc.ps marksweep.time": 47, 


11-8 ”访问 metrics 


(9) mappings 


Y 


访问 http://localhost: 8080/mappings, Ru K] 
11-9 所 示 。 


@ localhost:8080/mappin: x 


€ Q fi [5localhost:8080/mappings 


"xel' "self" 
"href": “http://localhost: 8080/mappings” 


"bean' "resourceHandl erMapping" 


"bean": “resourceHandlerMapping” 


"f**/favicon ico”: { 
"bean": “faviconHandlerMapping” 


"bean": “requestMappingHandlerMapping”, 
“method” "public org. springframework. http. ResponseEntity< java. util. Map<java. lang. String, 


java. lang.Object>> 
org. springf ramework. boot. autoconf igure. web. BasicErrorController.error (javax. servlet. http. HttpServlet 


Request)” 


" {L/error], produces=[text/htm1] }" { 
"bean": “requestMappingHandlerMapping”, 
"method": “public org. springframework. web. servlet. ModelAndView 
org. springf ramework. boot. autoconf igure. web. BasicErrorController. errorHtml (javax. servlet. http. HttpSer v 


图 11-9 ”访问 mappings 
(10) shutdown 


shutdown 哨 点 默认 是 关闭 的 ， 我 们 可 以 在 
application.properties 中 开启 : 


endpoints.shutdown.enabled-true 


r^y 


shutdown 端 点 不 文 持 GET 提 交 ， 可 以 直接 在 浏览 
研 上 访问 地 址 ， 所 以 我 们 使 用 PostMan 来 测试 。 用 
POST 方式 访问 http:Wlocalhost: 8080/shutdown, 22% 
如 图 11-10 所 示 。 


控制 台 效 果 如 网 11-11 所 示 。 


Builder 


http-//localhost-8080/shut 


http://localhost:6080/shutdown 


Authorization 


No Auth 


Pretty Raw Preview 


"Links": [ 
t 


"rel": 


"href": 
3 


Params 


Headers (0) Pre-request script 


Status 2000K Time 333ms 


"self", 


"http: //localhost:8080/shutdown" 


"Shutting down, bye...' 


" LI 1 


图 11-10 访问 shutdown 


2015-08-24 11:21:16.339 INFO 2852 --- [ 
2015-08-24 11:21:16.343 INFO 2852 --- [ 


Thread-3] o.s.c.support.DefaultlifecycleProcessor : Stopping beans in phase © 


Thread-3] o.s.j.e.a.AnnotationMBeanExporter :[Unregistering JMX-exposed beans on shutdown 


11 


访问 http://localhost: 8080/trace, 3R É]11-12 


Btzn © 


图 11-11 ”控制 台 效 果 


trace 


g localhost:8080/trace x 


C fi D localhost:8080/trace 


"timestamp : 1440123604068, 
"info". { 
"method": “GET”, 
"path": "/mappings", 
"headers". { 
"request"; 1 
"host": "localhost:8080", 
"comection": “keep-alive”, 


“accept”: "text/html, application/xhtnl+«ml, application/xml ;q-0. 9, image/webp, */*; q-Ü 
.8*, 


"upgrade-insecurecrequests | "l^, 
“user-agent”:  "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537. 36 (KHTML, like 
Gecko) Chrome/44. 0. 2403. 125 Safari/637. 36", 
"accept-encoding': “gzip, deflate, sdch', 
"accept-language':  "zh-CN, zh;q-0. 8, en; 于 0. 6, zh-TW: q-0. 4, it ;q70. 2" 
kh 
"response" 1 
"X-àpplication-Context': “application”, 
"Content-Type".  "application/json;charset-UTF-8", 
"Transfer-Encoding': “chunked”, 
"Date": “Fri, 21 Aug 2015 02:20:04 GMT", 
"status". "200" 


图 11-12 ”访问 trace 


-— 


11.1.3. ”定制 端点 


定制 端点 一 般 通 过 endpoints+ 端 点 名 + 属性 名 来 设 


置 ， 每 段 之 间 用 . 隅 开 。 
(1) 修改 端点 id 


endpoints.beans.id=mybeans 


此 时 我 们 访问 的 端点 地 址 就 变 成 了 : 
http://localhost: 8080/mybeans ° 


(2) 开局 端点 
例如 我 们 开启 shutdown 闹 点 : 
endpoints.shutdown.enabled-true 
(3) 关闭 端点 


关闭 beans 端 点 : 


endpoints.beans.enabled-false 


(4) 只 开局 所 需 端点 


大 只 开局 所 需 并 点 的 话 ， 我 们 可 以 通过 关闭 所 有 
的 咒 点 ， 人 然后 再 开局 所 需 端点 来 实现 ， 例 如 


endpoints.enabled-false 
endpoints.beans.enabled-true 


(5) 定制 端点 访问 路 径 
BRU BJ 53,73 IR] Ae TET Ho REY, All 
http://localhost: 8080/beans。 我 们 可 以 通过 下 面 配置 
修改 : 


management.context-path-/manage 


此 时 我 们 的 访问 地 址 就 变 成 了 : http://localhost: 
8080/manage/beans 


(6) 定制 端点 访问 端口 
_ 当 我 们 基于 安全 的 考虑 ， 不 曝露 端点 的 端口 到 外 
部 时 ， 就 需要 应 用 本 身 的 业务 端口 和 端点 所 用 的 端口 
使 用 不 同 的 端口 。 我 们 可 以 通过 如 下 配置 改变 端点 访 
问 的 端口 : 
management .port=8081 
(7) 关闭 http 端 点 
管理 http 端 点 可 使 用 下 面 配置 实现 : 


management .port=-1 


11.1.4 上 自 定义 端点 


= Spring Boothe FEA sin AN Be TP EBT FF RAY Ra 
求 ， 而 我 们 又 需要 对 特殊 的 应 用 状态 进行 监控 的 时 
候 ， 束 需要 目 定 义 一 个 端 护 。 


本 例 演示 当 应 用 改变 了 一 个 变量 的 状态 时 ， 我 们 
BY LBS ed P8 Bs ASIANS © 


我 们 只 需 继 承 一 个 AbstractEndpoint 的 实现 类 ， 并 
将 其 注册 为 Bean 即 可 。 


1. 状 态 服务 


package com.wisely.chi11 1; 
import org.springframework.stereotype.Service; 


@Service 
public class StatusService { 


private String status; 
public String getStatus() { 


return status; 
} 


public void setStatus(String status) { 
this.status = status; 
} 


AS HAE 
此 类 无 任何 特别 ， 仅 为 改变 status 的 信 。 
2. EL XE SOR, 


package com.wisely.chi11 1; 


import org.springframework.beans.BeansException; 

import 
org.springframework.boot.actuate.endpoint.AbstractEndpoint; 
import 
org.springframework.boot.context.properties.ConfigurationPropert 
ies; 

import org.springframework.context.ApplicationContext; 


import org.springframework.context.ApplicationContextAware; 


@ConfigurationProperties(prefix = "endpoints.status", 
ignoreUnknownFields = false) //1 

public class StatusEndPoint extends AbstractEndpoint<String> 
implements ApplicationContextAware{//2 


ApplicationContext context; 


public StatusEndPoint() { 
super("status"); 
j 


@Override 
public String invoke() { //3 
StatusService statusService = 
context.getBean(StatusService.class); 


return "The Current Status is 
:"+statusService.getStatus(); 


} 


@Override 
public void setApplicationContext(ApplicationContext arg0) 
throws BeansException { 
this.context - arg0; 


代码 解释 


(通过 @ConfigurationProperties 的 设置 ， 我 们 可 
以 在 application.properties 中 通过 endpoints.status 配 置 
我 们 的 端点 。 


(22K AbstractEndpoint2s, AbstractEndpointzé 
Endpoint 接 口 的 抽象 实现 ， 当 前 类 一 定 要 重 写 invoke 


Za 


方法 。 de i L1 nf 以 让 当 Hi 
类 对 Spring 容 器 的 资源 有 意识 ， 即 可 访问 容器 的 资 
Ui ° 


(9) 通 过 重 写 invoke 方 法 ， 返 回 我 们 要 监控 的 内 


Ji 


3.1: 9m 4 JE XE S TRU Tat TE a 


package com.wisely.chi11 1; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.SpringApplication; 

import org.springframework.boot.actuate.endpoint.Endpoint; 
import 
org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.context.annotation.Bean; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 


QSpringBootApplication 
QRestController 
public class DemoApplication { 
@Autowired 
StatusService statusService; 


public static void main(String[] args) { 
SpringApplication.run(DemoApplication.class, args); 
J 


QBean //1 

public Endpoint<String> status() { 
Endpoint<String> status = new StatusEndPoint(); 
return status; 

} 

@RequestMapping("/change") //2 

public String changeStatus(String status){ 
statusService.setStatus(status); 

return "OK"; 


} 


代码 解释 

注册 端点 的 Bean。 

定义 控制 需 方 法 用 来 改变 status。 
4511 


局 动 程序 ， 访 问 http:Wlocalhost: 8080/status, 
时 效果 如 图 11-13 所 示 。 


zs 


@ localhost:8080/status x 


e C f [58:10:10 £61 


The Current Status is :null 


图 11-13 ”访问 status 


当 我 们 通过 控制 硕 访 问 http:/localhost: 
8080/change? status=running， 改 变 status 的 值 的 时 
候 ， 如 图 11-14 所 示 。 


图 11-14 ”改变 status 的 值 


我 们 在 通过 访问 http:/Wlocalhost: 8080/status 查 看 
status 的 状态 时 ， 结果 如 图 11- 15 所 示 E 


@ localhost8080/sta: x \ a localhost:8080/cha x 


— Q fi D localhost:8080/status 


The Current Status is :running 


图 11-15 ”查看 status 的 状态 


11.1.5 HE X HealthIndicator 


Health 信 息 都 是 从 ApplicationContext 中 所 有 的 
HealthIndicator 的 Bean 中 收集 的 ，Spring 中 内 置 了 一 些 
HealthIndicator， 如 表 11-2 所 示 。 


表 11-2 Spring 中 内 置 的 HealthIndicator 


名 W 


DiskSpacheHealthIndicator 


SABER tk 25 [n] 


DataSourceHealthIndicator 


Sill] DataSource 连接 是 否 能 获得 


ElasticsearchHealthIndicator 


t&l] ElasticSearch HEF 否 运 行 


JmsHealthIndicator 


will] IMS 消息 代理 是 否 在 运行 


MailHealthIndicator 


仿 测 邮件 服务 器 是 否 在 运行 


MongoHealthIndicator 


Sil] MongoDB 是 否 在 运 和 


RabbitHealthIndicator 


ill] RabbitMQ 是 否 在 运 和 


Hi xk 


RedisHealthIndicator 


检测 Redis 是 否 在 运行 


SolrHealthIndicator 


检测 Redis 是 否 在 运行 


在 本 地 我 们 讲述 了 如 何 定制 目 己 的 
HealthIndicator， 定 制 目 己 的 HealthIndicator 我 们 只 需 
定 一 个 实现 HealthIndicator 接 口 的 类 ， 并 注册 为 Bean 
即 可 。 接 看 上 面 的 例子 ， 我 们 依然 通过 上 例 的 status 
I 只 有 当 status 的 信 为 ranning 时 才 为 
FRE o 


1.HealthIndicator3 Jl 25 


package com.wisely.chi1 1; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.actuate.health.Health; 
import org.springframework.boot.actuate.health.HealthIndicator; 
import org.springframework.stereotype.Component; 
Component 
public class StatusHealth implements HealthIndicator {//1 
@Autowired 
StatusService statusService; 


@Override 
public Health health() { 
String status = statusService.getStatus(); 


if(status == null||!status.equals("running"))( 
return Health.down().withDetail("Error", "Not Running").build(); 
//2 


j 
return Health.up().build(); //3 
} 


代码 解释 


实现 HealthIndicator 接 口 并重 写 health () 77 
法 。 


(9) 当 status 的 值 为 非 running 时 构造 失败 。 
(3 其 余 情况 运行 成 功 。 
23511 


运行 程序 ， 访 问 http://localhost: 8080/health, 4 
图 11-16 所 示 。 


@ localhost8080/health x 
€ C fi |5localhost:8080/health 


{ Parsed 


"status": “DOWN”, 

“statusHealth”: { 
"status": “DOWN”, 
“Error”: "Not Running" 


"diskSpace": { 
"status": “UP”, 
“total”: 118958563328, 
"free": 75690139648. 
“threshold”: 10485760 


b. 
“links”: E 
{ 
“rel”: “self”, 
“bref”: “http: // localhost: 8080/health" 


图 11-16 ”访问 health 
这 时 我 们 修改 status 的 值 为 ranning， 访 问 
http://localhost: 8080/change? status=running， 如 图 
11-17 所 示 。 


@ localhost8080/health x / g@ localhost:8080/change? x 


e Q fi D localhost:8080/change?status=running 


OK 


图 11-17 访问 running 


再 次 访问 http:Wlocalhost: 8080/health, "m 


11-18 所 示 。 


zs 口 
@ localhost:8080/health x \ @ localhost:8080/change? x 
E Q fi |D localhost:8080/health EET 
{ Raw Parsed 
}, 
"diskSpace": { 
"status": “UP”, 
“total”: 118958563328, 
"free": 75686649856, 
“threshold”: 10485760 
i, 
“links” [ 
{ 
“rel”: “self”, 
“href "http: // localhost: 8080/health" 
H 
1 
} 
图 11-18 ”再 次 访问 heath 


11.2 JMX 


我 们 也 可 以 通过 JMX 对 应 用 进行 监控 和 管 
理 。 本 万 应 用 上 一 节 的 例子 演示 


在 控制 侣 调用 Java 内 置 的 jconsole 来 实现 JMX 
监控 ， 如 图 11-19 所 示 。 


Microsoft Windows [hRAS 10. 0. 10240] 
Lc) 2015 Microsoft Corporation. All rights reserved. 


o: \Users\wisely>jconsole 


11-19 调用 jconsole 


这 时 会 打开 jconsole 页 面 ， 选 择 当 前 程序 的 进 
fF, x 图 11-20 所 示 。 


图 11-20 jconsole 页 面 


进入 界面 后 ， 在 MBean 标 签 的 
org. springframework. boot 域 下 可 对 我 们 的 程序 进行 
监控 和 省 理 ， 如 图 11-21 所 示 。 


图 ^ zm 
国 IE SUUM II 
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Mapleaentasicn frt 
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endpsint 

Ho wassCsnfi parati enRapsrtndpsine 
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GD confi pe ati enr eger ti a Baer tadi || is ariama 

HO damp Bnd aine 

SOD ami rarmaxctindpeint o 

局 万 leaLnkiadysins 498TU 
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f 
diskSpacezistmtussUP, toral=] 18958563328, freesT6132704 
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图 11-21 MBean 标 签 


115 SSH 


我 们 还 可 以 通过 SSH 或 TELNET 监 挖 和 管理 
我 们 的 应 用 ， 这 一 点 Spring Boot 古 借助 CraSH 
(http://www.crashub.org) 来 实现 的 。 在 应 用 中 ， 
我 们 只 需 在 Spring Boot 项 目 中 添加 spring-boot- 
starter-remote-shell X WW EW Ay ° 


11.3.1 新 建 Spring Boot 项 目 


#tzSpring Boot 项 目 ， 依 赖 为 Remote Shell 
(spring-boot-starter-remote-shell) 。 


项 E 信息 : 


groupId: com.wisely 
arctifactId:chi11 3 
package: com.wisely. ch11 3 


11.3.2 ”运行 


局 动 程 序 ， 此 时 控制 台 会 提示 SSH 访 问 的 密 
码 ， 如 图 11-22 所 示 。 


,3 NOR 
ER 
Ww FEM TTT Pel, 23523 
l tb} LAS LEA Ss 
=========|_|==============|  /=/_/_/_/ 
: Spring Boot :: (v1.3.0.M4) 
2015-08-24 15:17:04.626 INFO 3924 --- [ main] com.wisely.ch12 3.Ch123Appl 
2015-08-24 15:17:04.783 INFO 3924 --- [ main] s.c.a.AnnotationConfigAppli 
2015-08-24 15:17:05.502 INFO 3924 --- [ main] roperties$SimpleAuthenticat 
Using default password for shell access: 1fb7a6d6-2bb5-4851-88bd-23f298011687 
2015-08-24 15:17:06.432 INFO 3924 --- [ main] 0.5.j.e.a.AnnotationMBeanEx 
2015-08-24 15:17:06.436 INFO 3924 --- [ main] o.s.c.support.DefaultLifecy 
2015-08-24 15:17:06.494 INFO 3924 --- [ main] com.wisely.ch12 3.Ch123Appl 


图 11-22 SSH 访 问 的 密码 


这 样 隐 可 以 通过 下 面 信息 登 孙 我 们 的 程序 
(SSH 客 户 端 可 使 用 puTTY、SecureCRT 等 ) ， 登 
条 界面 如 图 11-23 所 示 。 


主机 :localhost 
端口 :2000 
账号 :user 


密码 : 上 面 截 图 


Firewall: ‘None 


Authentication 


[/]Password 
[7]PublicKey 
[7]Keyboard Interactive 
[7]GSSAPI 


[ ] Show quick connect on startup [7] Save session 
[ JOpen in a tab 


图 11-23 ”登录 界面 
登录 后 的 效果 如 图 11-24 所 示 。 


localhost (1) - SecureCRT 
Ele Edit View Options Transfer Script Tools Window Help 
AJ 33 [33 53 289 Enter host <Alt+R> R e dà L3 52 c3 me © 
4 


| © localhost (1) x | 


:: Spring Boot :: (v1.3.0. M4) on wisely-PC 
- 


wv 


Ready ssh2: AES-128-CTR 8, 3 24Rows,80Cols  VT100 CAP NUM 


图 11-24 ”登录 后 的 效果 


(1) help 
输入 help 命 令 ， 获 得 命令 列表 ， 如 图 11-25 所 


localhost - SecureCRT - 可 | x 
File Edit View Options Transfer Script Tools Window Help 
a SJ C3) $3 2) Enter host <Alt+R= 22.4 dà. e i ) eb? ? [7] [sal 


LELI D2. 
-一 村 下 NE 

—————— EN A 

:: Spring Boot :: (Vv1.3.0.M4) on wisely-PC 
» help 
Try one of these commands with the -h or --help switch: 
NAME DESCRIPTION 
autoconfig Display auto configuration report from Applicationcontext 
beans Display beans in OO 
cron manages the cron plugin 
dashboard a monitoring dashboard 
egrep search filets) for lines that match a pattern 
endpoint Invoke actuator endpoints 
env display the term env 
filter a filter for a stream of map 
java various java language commands 
jnx Java Management Extensions 

ul java.util. logging commands 
jvm Jw informations 

ess opposite of more 
mail interact with emails 
man format and display the on-line manual pages 
metrics Display metrics provided by Spring Boot 
shell shell related command 
sleep sleep for some time 
sort sort a map 
system vm system properties commands 
thread JWM thread commands 
help provides basic help v 
Ready ssh2: AES-128-CTR — 31, 3 31 Rows, 78 Cols  VT100 CAP NUM 


图 11-25 命令 列表 
(2) metrics 


输入 metrics 命 令 ， 效 果 如 图 11-26 所 示 。 


| 图 localhost (1) - SecureCRT 
File Edit View apum Transfer Script Tools Window Help 
a HO S t <Alt+R 2848 837371 e 
+ localhost (1) x z 


processors 
instance. uptime 674057 
uptime 676108 


. unloaded 
gc. ps_scavenge. count 
gc. ps_scavenge. time 
d ps_marksweep. count 


ssh2: AES-128-CTR 24, 1 24 Rows, 80 Cols VT100 CAP NUM 


图 11-26 输入 metrics 命 令 
(3) endpoint 
输入 下 面 命令 获得 端点 列表 ， 如 图 11-27 所 


—— 


7e 


endpoint list 


localhost (1) - SecureCRT 

File Edit View Options Transfer Script Tools Window Help 

EQ hotan — 5A A SE TEST 9 
localhost (1) x 


» endpoint Tist 

environmentEndpoint 

healthEndpoint 

beansEndpoint 

infoEndpoint 

metricsEndpoint 

traceEndpoint 

dumpEndpoint 

autoconf igurationReportEndpoint 
configurationPropertiesReportEndpoint 


zi v 


ssh2: AES-128-CTR 12, 3 12 Rows, 92 Cols  VT100 CAP NUM 


图 11-27 端点 列表 


调用 某 一 个 闹 吕 ， 如 调用 health， 如 图 11-28 
所 示 。 


endpoint invoke health 


图 localhost (1) - SecureCRT 一 口 x 
File Edit View Options Transfer Script Tools Window Help 
409) 539 CoG) 2€). Enter host <Alt+ A sug FB t e 


+ localhost (1) x 4 b 


^ 
> nt invoke 
{status=UP, diskSpace={status=UP, total-118958563328, free=76133871616, threshold=10485760}} 


Ready ssh2: AES-128-CTR 5, 3 5 Rows, 92 Cols VT100 CAP NUM 


11-28 调用 health 
11.3.4 定制 登录 用 户 


我 们 可 以 通过 在 application.properties 下 定制 
下 面 的 属性 ， 实 现 用 户 的 账号 冤 码 的 定制 : 


shell.auth.simple.user.name-wyf 
shell.auth.simple.user.password-wyf 


11.3.5 扩展 命令 


可 以 在 spring-boot-starter-remote-shell.jar 中 看 
到 Spring Boot 为 我 们 定制 的 命令 ， 如 图 11-29 所 
不 (0) 


v (aa spring-boot-starter-remote-shell-1.3.0.M4 jar 
v £4 commands.crash 


autoconfig.groovy 


| beans.groovy 


U [uy [ 


l empont groovy 
| login.groovy 

B metrics.groovy 
ETA-INF 


图 11-29 Spring Boot 定 制 的 命令 


如 beans.groovy 的 代码 为 : 


package commands 


Import 
org.springframework.boot.actuate.endpoint.BeansEndpoint 


class beans ( 


QUsage("Display beans in ApplicationContext") 
@Command 
def main(InvocationContext context) { 

def result = [:] 


context.attributes['spring.beanfactory'].getBeansOfType(Bea 
nsEndpoint.class).each ( name, endpoint -> 
result.put(name, endpoint.invoke()) 


j 


result.size() -- 1 ? result.values()[0] : result 


需要 特别 指出 的 是 ， 这 里 使 用 了 Groovy 语 言 
来 编制 命令 ，Groovy 语 言 是 由 Spring 主导 的 运行 
于 JVM 的 动态 语言 ， 是 可 以 蔡 代 Java 作 为 开发 语 
言 的 。 在 这 里 还 需 说 明 的 是 ，Spring Booth Ay LA 
用 Java 语 言 开 发 ， 也 可 以 用 Groovy 语 言 开发 ， 本 
书 为 了 诚 少 学 习 曲 线 ， 以 及 考虑 绝 大 数 谈 者 的 使 
用 现状 ， 所 以 没有 对 Groovy 语 言及 Groovy 开 发 
Spring 进行 介绍 ， 读 者 如 有 兴趣 可 目 行 学 习 
Groovy ? 


另 一 个 值得 注意 的 是 InvocationContext， 我 们 
可 以 通过 InvocationContext 获 得 表 11-3 所 示 的 属 
性 。 


表 11-3 属性 


属性 名 mi 


ng.boot. version Spring Boot 的 版 本 


Spring 框架 的 版 本 


iJj\4] Spring 的 BeanFactory 


"Ha |" |" [M 
B/E |e |e 
B/E |B 
& le |. 

m 

E 


访问 Spring 的 Enviroment 


这 里 将 以 Groovy 语 言 淘 示 一 个 命令 的 定制 ， 
命令 可 放 在 以 下 目录 ，Spring Boot 会 目 动 扫描 : 


classpath*:/commands/** 
classpath*:/crash/commands/ * * 


TEsrc/main/resources M #1 commands X. fF 
3€. #hello.groovy, AAU P: 


package commands 
import org.crsh.cli.Command 
import org.crsh.cli.Usage 
import org.crsh.command.InvocationContext 
class hello ( 
QUsage("Say Hello")//1 
@Command//2 
def main(InvocationContext context) { 


def bootVersion = 
context.attributes['spring.boot.version'];//3 

def springVersion - 
context.attributes['spring.version']//4 

return "Hello,your Spring Boot version is 


"+bootVersion +",your Spring Framework version is 
"+springVersion //5 


j 


代码 解释 
四 使 用 @Usage 注 解 解释 该 命令 的 用 途 。 


人 [e] 
=f 


(9) 获 得 Spring Boot 的 版 本 ， 注 意 Groovy 的 方 
法 和 变量 声明 天 键 子 为 def 。 


AIRF Spring 框架 的 版 本 。 


此 时 我 们 运行 程序 ， 并 以 SSH 客 户 问 登录 ， 
输入 hello 命 令 ， 可 获得 如 图 11-32 所 示 结 果 。 


localhost - SecureCRT 一 口 x 
File Edit View Options Transfer Script Tools Window Help 
Aid Sid Co) d €. Enter host <Alt+R ^a Ga Ft e EM 
** localhost 4b 
CT -— Ec NE 00 
Ce» | IT =e | AY 
Wy een 3.113 
I ——]1 三 = lI} = 33 2177 
一 一 一 一 一 一 一 一 一 | _ | SS SS SS | / jm af 
23 5 g Boot (v1.3.0.M4) isely-PC 
> hell 
"a y pring t ve 1.3.0.M4, y pring k 4.2.0 
> 
Ready ssh2: AES-128-CTR 10, 3 13 Rows, 91 Cols  VT100 CAP NUM 


,二 /一 


图 11-32 ”运行 程序 


第 12 章 ”分 布 式 系统 开发 
12.1 微服 务 、 原 生 云 应 用 


微服 务 (Microservice) 是 近 两 年 来 非常 火 的 
概念 ， 它 的 含义 是 : 使 用 定义 好 边界 的 小 的 独立 
组 件 来 做 好 一 件 事情 。 微 服务 是 相对 于 传统 单 块 
式 架构 而 言 的 。 


单 块 式 届 构 是 一 份 代 码 ， 部 署 和 伸缩 都 是 基 
TADE ° ENT Ae em Tabs, (he 
Teg se n] HAIER ^ BS PEE SR AT RE 
周期 以 及 违反 单一 功能 原则 (Single 
Responsibility Principle) 。 微 服务 的 出 现 解决 了 
这 个 问题 ， 它 以 单个 独立 的 服务 来 做 一 个 功能 ， 
且 要 做 好 这 个 功能 。 但 使 用 微服 务 不 可 避免 地 将 
功能 按照 边界 拆 分 为 单个 服务 ， 体 现 出 分 布 式 的 
特征 ， 这 时 每 个 微服 务 之 间 的 通信 将 是 我 们 要 解 
次 的 问题 。 


Spring Cloudy H MARA RRS AN A 
用 到 的 问题 给 出 了 完整 的 解决 方案 。Spring Cloud 
基于 Spring Boot， 为 我 们 提供 了 配置 管理 、 服 务 
发 现 、 断 路 强 、 代 理 服务 等 我 们 在 做 分 布 式 开发 
时 利用 问题 的 解决 方案 。 


基于 Spring Cloud 开 发 的 程序 特别 适合 在 
Docker 或 者 其 他 专业 PaaS (平台 即 服 务 ， 如 Cloud 
Foundry) 部 署 ， 所 以 又 称 作 原 生 云 应 用 (Cloud 
Native Application) 。 


12.2 Spring Cloud 快 速 入 门 


12.2.1 配置 服务 


Spring Cloud Bt f Config Server， 它 有 在 分 
布 式 系统 开发 中 外 部 配置 的 功能 。 通 过 Config 
mm 我 们 可 以 集 中 存储 所 有 应 用 的 配置 文 


Config Server 文 持 在 git 或 者 在 文件 系统 中 放 
置 配置 文件 。 可 以 使 用 以 下 格式 来 区 分 不 同 应 用 
的 不 同 配置 文件 : 


/{application}/{profile}[/{label} ] 
/{application}-{profile}.yml 
/{label}/{application}-{profile}.yml 
/{application}-{profile}.properties 
/{label}/{application}-{profile}.properties 


Spring Cloud 提 供 了 注解 @EnableConfigServer 
来 局 用 配置 服务 。 


12.2.2 ”服务 发 现 


Spring Cloud if Netflix OSS 的 Eureka 来 实现 
服务 发 现 ， 服 务 发 现 的 主要 目的 是 为 了 让 每 个 服 
务 之 间 可 以 互相 通信 。Eureka Server 为 微服 务 注 
MPE e 


Spring Cloud 使 用 注解 的 方式 提供 了 Eureka 服 
Zim (@EnableEurekaServer) 和 客户 端 
(@EnableEurekaClient) ° 


12.2.3 ”路 由 网 关 


路 由 网 关 的 主要 目的 是 为 了 让 所 有 的 微服 务 
对 外 只 有 一 个 接口 ， 我 们 只 需 访 问 一 个 网 关 地 
4 即 可 由 网 关 将 我 们 的 请 求 代理 到 不 同 的 服务 


Spring Cloud 是 通过 Zuul 米 实现 的 ， 文 持 目 动 
PE FRY SI TE Eureka Server 上 注册 的 服务 。Spring 
Cloud 提 供 了 注解 @EnableZuulProxy 来 启用 路 由 代 
理 。 


12.2.4 负载 均衡 


Spring Cloud 提 供 了 Ribbon 和 Feign 作 为 客户 
端的 负载 均衡 。 在 Spring Cloud 下 ， 使 用 Ribbon 直 
接 注 入 一 个 RestTemplate 对 象 即 可 ， 此 
RestTemplate 已 做 好 负载 均衡 的 配置 ;而 使 用 
Feign 只 和 需 定 义 个 注解 ， 有 Q@FeignClient 注 解 的 接 
口 ， 然 后 使 用 @RequestMapping 注 解 在 方法 上 映 
at 的 REST 服 务 ， 此 方法 也 是 做 好 负载 均衡 配 


12.2.5 WESS 


断路 器 (Circuit Breaker) ， 主 要 是 为 了 解决 
当 某 个 方法 调用 失败 的 时 候 ， 调 用 后 备 方法 来 詹 
FRUTTA, DARRE  BHIEZEEXTEEASEI] 
BB 。 


Spring Cloud 使 用 @EnableCircuitBreaker 来 局 
用 断路 古文 持 ， 使 用 @HystrixCommand 的 
fallbackMethod 来 指定 后 备 方法 。 


Spring Cloud 还 给 我 们 提供 了 一 个 控制 台 来 监 
控 断 路 侨 的 运行 情况 。 通 过 
(@EnableHystrixDashboard 注 解 开启 。 


12.3 XER 


实战 部 分 主要 由 6 个 微服 务 组 成 : 


config: 配置 服务 右 ， 本 例 为 person-service 和 
some-service 提 供 外 部 配置 。 


discovery: Eureka Server 为 做 服务 提供 注册 。 


person: 为 UI 模块 提供 保存 personH 的 REST 上 服 
务 。 


some: 为 UI 模块 返回 一 段 字 从 串 。 

UL 作为 应 用 网 天 ， 提 供 外 部 访问 的 唯一 入 
口 。 使 用 Feign 消 帘 person 服 务 、Ribbon 消 费 some 
服务 ， 且 部 提 供 断 路 絮 功 能 ; 

monitor: 监控 UI 模块 中 的 断路 疾 。 


本 例 没 有 完全 列 出 代码 ， 读 者 可 目 行 翻阅 源 
人 码 ch12。 


12.3.1 ”项目 构 建 


狐 建 模块 化 的 maven 项 目 ch12， 其 pom.xml 文 
件 的 主要 部 分 如 下 。 


(1) 使 用 <modules> 标 签 来 实现 模块 化 : 


<modules> 
<module>config</module> 
<module>discovery</module> 
<module>ui</module> 
<module>person</module> 
<module>some</module> 
<module>monitor</module> 

</modules> 


(2) 使 用 Spring-cloud-starter-parent 赫 代 
Spring-boot-starter-parent， 其 具备 spring-boot- 
starter-parent 的 同样 功能 并 附加 了 Spring Cloud 的 依 
赖 ， 当 前 最 新 稳定 版 为 Angel.SR3: 


<parent> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-parent</artifactId> 
«version» Angel.SR3</version> 
<relativePath/> 
</parent> 


(3) 在 此 pom.xml 文 件 里 添加 的 dependency 
对 所 有 的 子 模块 都 是 有 歼 的 ， 即 在 子 模块 不 用 再 
额外 添加 这 些 依赖 ; 


«dependencies» 

«dependency» 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter- 

actuator«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter- 

test</artifactId> 
<scope>test</scope> 
</dependency> 
</dependencies> 


12.3.2 ”服务 发 现 


Discovery (Eureka Server) 


1. ORT 


服务 发 现 依赖 于 Eureka Server， 所 以 本 模块 加 
上 如 下 依赖 即 可 : 


<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -eureka- 
server</artifactId> 
</dependency> 
</dependencies> 


2. BETES 


package com.wisely.discovery; 
import org.springframework.boot.SpringApplication; 
import 
org.springframework.boot.autoconfigure.SpringBootApplication 
import 
org.springframework.cloud.netflix.eureka.server.EnableEureka 
Server; 
QSpringBootApplication 
@EnableEurekaServer 
public class DiscoveryApplication { 

public static void main(String[] args) { 


SpringApplication.run(DiscoveryApplication.class, args); 
} 


代码 解释 

一 个 常规 的 Spring Boot 项 目 ， 我 们 只 需要 使 
用 @EnableEurekaServer 注 解 开 局 对 EurekaServer 的 
文 持 即 可 。 

3.B 


在 云 计 算 环境 下 ， 习 惯 上 使 用 YAML 配 置 ， 
此 处 我 们 也 采用 YAML 配 置 。 


application.yml: 


server: 
port: 8761 #1 


eureka: 
instance: 
hostname: localhost #2 
client: 
register-with-eureka: false #3 
fetch-registry: false 


代码 解释 

(当前 Eureka Server 服 务 的 端口 号 为 8761。 
(当前 Eureka Server 的 hostname 为 localhost。 
(3) 当 前 服务 不 需要 到 Eureka Server 上 注册 。 


12.3.3 ”配置 一 一 Config (Config Server) 


1. FAR 


Spring Cloud 为 我 们 提供 了 作为 配置 服务 的 依 
赖 spring-cloud-config-server， 以 及 作为 eureka 客 户 
JH HC tspring-cloud-starter-eureka: 


«dependencies» 

«dependency» 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter</artifactId> 

</dependency> 


<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-config- 
server</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter - 
eureka</artifactId> 
</dependency> 
</dependencies> 


2. BETES 


package com.wisely.config; 


import org.springframework.boot.SpringApplication; 
import 
org.springframework.boot.autoconfigure.SpringBootApplication 


import 
org.springframework.cloud.config.server.EnableConfigServer; 
import 
org.springframework.cloud.netflix.eureka.EnableEurekaClient; 


QSpringBootApplication 
@EnableConfigServer //1 
@EnableEurekaClient //2 

public class ConfigApplication { 


public static void main(String[] args) { 


SpringApplication.run(ConfigApplication.class, 
args); 


代码 解释 


OEH (gEnableConfigServer7T AAC EARS 88 
的 文 持 。 


(2fi FH @EnableEurekaClient# JG fE 7j Eureka 
Server 的 客户 端的 文 持 。 


3.80. 


bootstrap.yml 


spring: 
application: 
name: config #1 
profiles: 
active: native #2 


eureka: 
instance: 
non-secure-port: ${server.port:8888} #3 
metadata-map: 
instanceId: ${spring.application.name}:${random. value} 
#4 
client: 
service-url: 
defaultZone: 
http://${eureka.host:localhost}:${eureka.port:8761}/eureka/ 
#5 


代码 解释 


这 里 对 bootstrap.yml 做 一 下 解释 ，Spring 
Cloudy Fa $e 41 H bootstrap.yml 


(bootstrap.properties) 负责 从 外 部 资源 加 载 配置 
属性 。 


(在 Erueka Server 注 册 的 服务 名 为 config。 
| (配置 服务 名 使 用 本 地 配置 (默认 为 git 配 


G@) 非 SSL 端 口 ， 大 环境 变量 中 serverport 有 
值 ， 则 使 用 环境 变量 的 值 ， 没 有 则 使 用 8080。 


(4) 配 置 在 Eureka Server 的 实例 ID。 
@Eureka 客 户 端 设置 Eureka Server 的 地 址 。 
application.yml 


spring: 
cloud: 
config: 
server: 
native: 
search-locations: classpath:/config #1 


server: 
port: 8888 


代码 解释 


配置 其 他 应 用 所 需 的 配置 文件 的 位 置 位 于 类 
路 径 下 的 config 目 孙 下 ， 如 图 12-1 所 示 。 


wv © src/main/resources 
v Be config 


| person-docker.yml 


: - person.yml 


= some-docker.yml 


= some.yml 


412-1 config 
配置 文件 的 规则 为 : 应 用 名 +profile.yml。 


12.3.4 ”服务 模块 一 Person 服务 


1. FAR 


本 模块 需要 做 数据 库 操作 ， 故 添加 spring- 
boot-starter-data-jpa 依 赖 (在 开发 环境 下 使 用 
hsqldb， 在 Docker 生 产 环境 下 使 用 PostgreSQL ) ; 
本 模块 还 需要 使 用 Config Server 的 配置 ， 故 添加 
spring-cloud-config-client 依 顿 。 


«dependencies» 
«dependency» 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter</artifactId> 


«/dependency» 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-config- 
client</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter- 
eureka</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId-» 
<artifactId>spring-boot-starter-data- 
jpa</artifactId> 
</dependency> 
<dependency> 
«groupId»org.hsqldb«/groupId» 
<artifactId>hsqldb</artifactId> 
</dependency> 
<dependency> 
«groupId»postgresql«/groupId» 
<artifactId>postgresql</artifactId> 
<version>9.1-901-1.jdbc4</version> 
</dependency> 
</dependencies> 


2. BETIS 


本 模块 没有 特别 值得 关注 的 代码 ， 主 要 是 实 
现 数据 库 的 一 个 保存 操作 ， 并 将 保存 操作 其 露 给 
UI 模块 调用 。 


package com.wisely.person.controller; 


import java.util.List; 


import 
org.springframework.beans.factory.annotation.Autowired; 


import org.springframework.data.domain.PageRequest; 

import org.springframework.web.bind.annotation.RequestBody; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RequestMethod; 
import 
org.springframework.web.bind.annotation.RestController; 


import com.wisely.person.dao.PersonRepository; 
import com.wisely.person.domain.Person; 


QRestController 

public class PersonController { 
@Autowired 
PersonRepository personRepository; 


@RequestMapping(value = "/save", method = 
RequestMethod.POST) 

public List<Person> savePerson(@RequestBody String 
personName) { 

Person p = new Person(personName) ; 

personRepository.save(p); 

List«Person» people - personRepository.findAll(new 
PageRequest(0, 10)).getContent(); 

return people; 


j 


3. Ed B 


bootstrap.yml: 


spring: 
application: 
name: person 
cloud: 
config: 
enabled: true 
discovery: 
enabled: true 
service-id: CONFIG #1 


eureka: 
instance: 
non-secure-port: ${server.port:8082} 
client: 
service-url: 
defaultZone: 
http://${eureka.host:localhost}:${eureka.port:8761}/eureka/ 


代码 解释 


指定 Config Server 的 服务 名 ， 将 会 通过 Eureka 
Server 发 现 Config Server ° 


在 开发 环境 下 使 用 hsqldb: (Config Server 下 
的 person.yml) 


spring: 
jpa: 
database: HSQL 


在 Docker 生 产 环境 下 使 用 PostgreSQL (Config 
Server 下 的 person-docker.yml) 


spring: 

jpa: 
database: POSTGRESQL 

datasource: 
platform: postgres 
url: jdbc:postgresql://postgres:5432/postgres 
username: postgres 
password: postgres 
driver-class-name: org.postgresql.Driver 


application.yml: 


server: 


port: 8082 
spring: 
jpa: 
hibernate: 


ddl-auto: update 


12.3.5 ”服务 模块 一 Some 服务 


1. FAR 


«dependencies» 

«dependency» 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-config- 

client«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter- 

eureka</artifactId> 

</dependency> 

</dependencies> 


2. BETIS 


package com.wisely.some; 


import org.springframework.beans.factory.annotation.Value 
import org.springframework.boot.SpringApplication; 
import 


org.springframework.boot.autoconfigure.SpringBootApplication 


£ 

import 
org.springframework.cloud.client.discovery.EnableDiscoveryCl 
ient; 

import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RestController; 


QSpringBootApplication 

QEnableDiscoveryClient 

QRestController 

public class SomeApplication { 
@Value("${my.message}") //1 
private String message; 


@RequestMapping(value = "/getsome") 
public String getsome(){ 
return message; 


public static void main(String[] args) { 
SpringApplication.run(SomeApplication.class, args); 


此 处 通过 @Value 注 入 的 全 来 目 于 Config 


Server ? 


在 开发 环境 下 (Config Server 下 的 


some.yml) 。 


my: 
message: Message from Development 


在 Docker 生 产 环境 下 (Config Server FAY 
some-docker.yml) 


my : 
message: Message from Production 


3. Ed Bi 


bootstrap.yml: 


spring: 
application: 
name: some 
cloud: 
config: 
enabled: true 
discovery: 
enabled: true 
service-id: CONFIG 
eureka: 
instance: 
non-secure-port: ${server.port:8083} 
client: 
service-url: 
defaultZone: 
http://${eureka.host:localhost}:${eureka.port:8761}/eureka/ 


application.yml: 
server: 
port: 8083 


12.3.6 ”界面 模块 UI (Ribbon, Feign) 


1. CRM 


本 模块 会 使 用 ribbon、feign、zuul 以 及 
CircuitBreaker， 所 以 需 添 加 相关 依赖 。 本 模块 是 
一 个 具有 有 界面 的 模块 ， 所 以 通过 webjar 加 载 了 一 些 
常用 的 脚本 框 染 : 


<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter- 
hystrix</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter- 
zuul</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-config- 
client</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter - 
eureka</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
«artifactiId»spring-cloud-starter- 
feign</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter - 
ribbon</artifactId> 
</dependency> 
<dependency> 


«groupId»org.webjars«/groupId» 
<artifactId>bootstrap</artifactId> 

</dependency> 

<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>angularjs</artifactId> 
<version>1.3.15</version> 

</dependency> 

<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>angular -ui-router</artifactId> 
<version>0.2.13</version> 

</dependency> 

<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>jquery</artifactId> 

</dependency> 

</dependencies> 


2. 关 键 代 码 
(1) AL: 


package com.wisely.ui; 


import org.springframework.boot.SpringApplication; 
import 
org.springframework.boot.autoconfigure.SpringBootApplication 


import 
org.springframework.cloud.client.circuitbreaker.EnableCircui 
tBreaker; 

import 
org.springframework.cloud.netflix.eureka.EnableEurekaClient; 
import 
org.springframework.cloud.netflix.feign.EnableFeignClients; 
import 
org.springframework.cloud.netflix.zuul.EnablezuulProxy; 


QSpringBootApplication 
QEnableEurekaClient 
QEnableFeignClients //1 


QEnableCircuitBreaker //2 
QEnablezuulProxy //3 
public class UiApplication { 
public static void main(String[] args) { 
SpringApplication.run(UiApplication.class, args); 


代码 解释 


通过 @EnableFeignClients 开 局 feign 客 户 端 
X ° 


(通过 @EnableCircuitBreaker 开 局 
CircuitBreaker 的 支持 。 


@@ 通 过 @EnableZuulProxy 开 启 网 关 代理 的 支 


iS 
(2) 使 用 feign 调 用 Person Service: 


package com.wisely.ui.service; 
import java.util.List; 


import org.springframework.cloud.netflix.feign.FeignClient; 
import org.springframework.http.MediaType; 

import org.springframework.web.bind.annotation.RequestBody; 
import 
org.springframework.web.bind.annotation.RequestMapping; 
import 
org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.ResponseBody; 


import com.wisely.ui.domain.Person; 


QFeignClient("person") 
public interface PersonService { 
QRequestMapping(method - RequestMethod.POST, value - 
"/save", 
produces = MediaType.APPLICATION_JSON_VALUE, 

consumes = MediaType.APPLICATION JSON VALUE) 

QResponseBody List<Person> save(@RequestBody String 
name); 


Í 
代码 解释 


我 们 只 需 通过 倘 单 的 在 接口 中 声明 方法 即 可 
调用 Person 服 务 的 REST 服 务 。 


(3) 调用 Person Service 的 断路 器 


package com.wisely.ui.service; 


import java.util.ArrayList; 
import java.util.List; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Service; 

import 
com.netflix.hystrix.contrib.javanica.annotation.HystrixComma 
nd; 

import com.wisely.ui.domain.Person; 


QService 
public class PersonHystrixService ( 


@Autowired 
PersonService personService; 


@HystrixCommand(fallbackMethod = "fallbackSave") //1 
public List<Person> save(String name) { 

return personService.save(name) ; 
} 


public List«Person» fallbackSave(){ 
List«Person» list = new ArrayList<>(); 
Person p = new Person("Person Service 故障 ")， 
list.add(p); 
return list; 


代码 解释 


(使 用 @HystrixCommand 的 fallbackMethod 参 
数 指定 ， 当 本 方法 调用 失败 时 ， 调 用 后 备 方法 
fallbackSave ? 


(4) 使 用 ribbon 调 用 Some Sevice, 34E H WT 
PE as: 


package com.wisely.ui.service; 


import 
org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Service; 

import org.springframework.web.client.RestTemplate; 


import 
com.netflix.hystrix.contrib.javanica.annotation.HystrixComma 
nd; 


QService 
public class SomeHystrixService ( 


@Autowired 
RestTemplate restTemplate; //1 


@HystrixCommand(fallbackMethod = "fallbackSome") //2 
public String getSome() { 
return 


restTemplate.getForObject("http://some/getsome", 
String.class); 


public String fallbackSome(){ 
return "some service 模 块 故 障 "; 


代码 解释 


在 Spring Boot 下 使 用 Ribbon， 我 们 只 需 注入 
一 个 RestTemplate 即 可 ，Spring Boot 已 为 我 们 做 好 
了 配置 。 


使 用 @HystrixCommand 的 fallbackMethod 参 数 
指定 ， 当 本 方法 调用 失败 时 调用 后 备 方法 
fallbackSome ° 


3.60 


bootstrap.yml: 


spring: 
application: 
name: ul 


eureka: 
instance: 
non-secure-port: ${server.port:80} 
client: 
service-url: 
defaultZone: 
http://${eureka.host:localhost}:${eureka.port:8761}/eureka/ 


application.yml 


server: 
port: 80 


12.3.7 ”上 断路 需 监 探 一 Monitor (DashBoard) 


1. FR 


«dependencies» 

«dependency» 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter-hystrix- 

dashboard</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
«artifactId»spring-cloud-starter- 

turbine</artifactId> 

</dependency> 

</dependencies> 


2. 主 要 代码 


package com.wisely.monitor; 

import org.springframework.boot.SpringApplication; 

import 
org.springframework.boot.autoconfigure.SpringBootApplication 


T 
import 


org.springframework.cloud.netflix.eureka.EnableEurekaClient; 
import 
org.springframework.cloud.netflix.hystrix.dashboard.EnableHy 
strixDashboard; 

import 
org.springframework.cloud.netflix.turbine.EnableTurbine; 


QSpringBootApplication 
@EnableEurekaClient 
@EnableHystrixDashboard 
@EnableTurbine 

public class MonitorApplication { 


public static void main(String[] args) { 
SpringApplication.run(MonitorApplication.class, 
args); 


} 
} 
3.60 


bootstrap.yml 


spring: 
application: 
name: monitor 


eureka: 
instance: 
nonSecurePort: ${server.port:8989} 
client: 
serviceUrl: 
defaultZone: 
http://${eureka.host:localhost}:${eureka.port:8761}/eureka/ 


application.yml 


server: 
port: 8989 


12.3.8 ”运行 


我 们 依次 局 动 DiscoveryApplication 、 
ConfigApplication， 后 面 所 有 的 微服 务 局 动 不 分 顺 
序 ， 最 后 局 动 MonitorApplication。 此 时 访问 
http://localhost: 8761, fi Eureka Server， 如 
12-2 所 示 。 


HE - (« 
门 加 国外 三 
B area ^ OD nesz 
DS Replicas 


Instances currently registered with Eureka 


"^ Application AM Availability Zones Status 
n/a (1 1 UP (1 1 


Ceneral Info 


图 12-2 ”查看 Eureka Server 
1. 访 问 UI 服 务 
ULAR Bie BTA HT, BERTARA 
理 。 在 实际 生产 环境 中 ， 服 务 絮 防火 墙 只 需 将 此 


端口 又 露 给 外 网 即 可 ， 访 问 http:Vlocalhost， 如 
12-3 所 示 。 


cha x/ @ merum 
C fi Ù localhost/#/person 
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图 12-3 ”访问 localhost 


(1) 调用 Person Service， 如 图 12-4 所 示 


@ Eureka 
e 


x / gi Rene x 
C fi |O localhost/#/person 


E: Apache Mesos (J vps Linux docker Android Spring Hacking + 下 载 内 容 & 设置 办 扩展 程序 
原生 云 应 用 


通过 Person Service 保 存 person 
11111111 


id:1,namc:11111111 


保存 


图 12-4 调用 person-service 


(2) 调用 Some service， 如 图 12-5 所 示 。 
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ER 


Message from Development 


图 12-5 调用 some-service 


2. TEE as 


此 时 停止 Person ServicefllSome Service, XZ 
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[12-6 ”停止 Person Service 


g Peras 
c C fF /localhost/2/some TABB¢é= 
E: QM O Apache Mesos C) vps ©) Unus C) docker Cì Android C) Spring © Hacking $ Tios 2 OU 办 rëna 


» D axess 
Bitk z: RH 


从 Some Service 获 得 
| am 


zome scrvicc tatam 


图 12-7 停止 Some Service 


3.8 BR dis tin fe 


访问 http:/localhost: 8989/hystrix.stream, 4] 
图 12-8 所 示 。 
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Hystrix Dashboard 


Clustar via Turbine (default clustar): http://turbine-hostname:port/turbine. stream 
Clustar via Turbine (custom clustar); http://turbine~hostname:port/ turbine, stream?cluster* 
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Singla Hystrix App: http://hystrix-app:port/hystrix, stream 


nc Title: 


图 12-8 访问 hystrix.stream 


输入 http://localhost/hystrix.stream， 如 图 12-9 
所 示 。 


gnt Xy gi Hystrix Dashboard 
€ Q fi D localhost:8989/hystrix.stream 
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Hystrix Dashboard 


http./localhosthystrix stream 


Cluster via Turbine (default cluster): http://turbine-hostname:port/turbine. stream 
Cluster via Turbine (custom cluster)? http://turbine-hostname:port/turbinoe. stream?cluster= 
[clusterNam:] 

Single Hystrix App: http://hystrix-app:port/hystrix. stream 


Delay: ms Title: 


图 12-9 输入 http://localhost/hystrix.stream 


监控 者 面 如 图 12-10 所 示 。 


g Stra Xj @@ Hystrix Monitor x 


€ Q f D localhost:8989/hystrix/monitor?stream=http%3A 
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Hystrix Stream: http://localhost/hystrix.stream HYSTRIX 


DEFEND YOUR APP 
Circuit Sort: Error then Vonume | Alphabetical | Voume | Error | Mean | Median | 99 | 99 | 92.5 


Success | Stvort-Circuited | 1:9 | ted | Failure | Error % 


Host: Q.0/s 
0.0/s 

Circuit Closed 

Hosts 1 90^ oms 
Median Oms én Oms 
Mear Oms 995m Oms 


Host 1 
Medan Oms m 
Mean Oms 995m Oms 


Thread Pools ‘Sort: Alghaberizel | Volume | 


图 12-10 ”监控 界面 


12.4 基于 Docker 部 署 


以 Spring Cloud 开 发 的 微服 务 程序 十 分 适合 在 
Docker 环 境 下 部 署 。 


12.4.1 Dockerfile 编 写 
以 上 6 个 微服 务 的 Dockerfile 的 编写 几乎 完全 
一 致 ， 此 处 只 以 config 模 块 为 例 。 
1.runboot.sh 脚 本 编写 


位 于 src/main/docker 下 : 


sleep 10 
java -Djava.security.egd-file:/dev/./urandom -jar 
/app/app.jar 


根据 局 动 顺序 ， 调 整 sleep 的 时 间 。 
2.Dockerfile 编 写 


位 于 src/main/docker 下 : 


FROM java:8 

VOLUME /tmp 

RUN mkdir /app 

ADD config-1.0.0-SNAPSHOT.jar /app/app.jar 
ADD runboot.sh /app/ 

RUN bash -c 'touch /app/app.jar' 

WORKDIR /app 

RUN chmod a-*x runboot.sh 

EXPOSE 8888 

CMD /app/runboot.sh 


为 不 同 的 微服 务 我 们 只 需 修改 : 
ADD config-1.0.0-SNAPSHOT.jar /app/app.jar 
PA tm A 
EXPOSE 8888 


3.DockerB'Jmaventti {+ 


TET ACN Las Am 2 Docker ta (RNAS mm. [i FH 
docker-maven-plugin 即 可 ， 在 所 有 程序 的 pom.xml 
内 增加 : 


<build> 
<plugins> 
<plugin> 
<groupId>com.spotify</groupId> 
<artifactId>docker -maven- 
plugin</artifactId> 
<configuration> 


<imageName>${project.name}:${project.version}</imageName> 


<dockerDirectory>${project.basedir}/src/main/docker</docker 
Directory> 


<skipDockerBuild>false</skipDockerBuild> 
<resources> 
<resource> 


<directory>${project.build.directory}</directory> 


<include>${project.build.finalName}.jar</include> 
</resource> 
</resources> 
</configuration> 
</plugin> 
</plugins> 
</build> 


4. 编 译 镜像 


使 用 docker-maven-plugin， 默 认 将 Docker 编 译 


到 ]localhost。 如 果 是 远程 Linux 服 务 器 ， 请 在 环境 
变量 中 配置 DOCKER_HOST， 本 例 的 Linux 服 务 
器 的 地 址 是 192.168.1.68， 如 图 12-11 所 示 。 


图 12-11 ”Linux 服 务 器 的 地 址 


在 控制 台 下 进入 ch12 目 录 ， 执 行 下 面 语句 : 


mvn clean package docker:build -DskipTests 


编译 完成 后 效果 如 图 12-12 所 示 。 


图 12-12 ”编译 后 效果 
查看 Linux 服 务 絮 上 的 镜像 ， 如 图 12-13 所 


图 12-13 ”Linux 服 务 器 上 的 镜像 


12.4.2 Docker Compose 


Docker Composez H 来 定义 和 还 全 多 罕 4 da SRI 
用 的 工具 。 关 于 DockerCompose 的 安装 和 使 用 请 


A @https://docs.docker.com/compose/ ° 


Docker Compose 使 用 一 个 docker-compose.yml 
来 挡 述 多 容 釉 的 定义 ， 使 用 下 面 命 令 运行 整个 应 
He 


docker-compose up 


12.4.3 Docker-compose.yml4a 5 


postgresdb: 
image: busybox 
volumes: 
- /var/lib/postgresql/data 


postgres: 
name: postgres 
image: postgres 
hostname: postgres 
volumes_from: 
- postgresdb 
# ports: 
# - "5432:5432" 
environment: 
- POSTGRES_USER=postgres 
- POSTGRES_PASSWORD=postgres 


discovery: 


image: "discovery:1.0.0-SNAPSHOT" 
hostname: discovery 
name: discovery 
ports: 
"8761:8761" 


config: 
image: "config:1.0.0-SNAPSHOT" 
hostname: config 
name: config 
links: 
- discovery 
environment: 
EUREKA HOST: discovery 
EUREKA PORT: 8761 
# ports: 
# - "8888:8888" 


person: 
image: person:1.0.0-SNAPSHOT 
hostname: person 
links: 
- discovery 
- config 
- postgres 
environment: 
EUREKA_HOST: discovery 
EUREKA_PORT: 8761 
SPRING_PROFILES ACTIVE: docker 
# ports: 
# - "8082:8082" 


some: 
image: some:1.0.0-SNAPSHOT 
hostname: some 
links: 
- discovery 
- config 
environment: 
EUREKA HOST: discovery 
EUREKA PORT: 8761 
SPRING PROFILES ACTIVE: docker 
# ports: 
# - "8083:8083" 


ui: 
image: ui:1.0.0-SNAPSHOT 
hostname: ui 
links: 
- discovery 
- config 
- person 
- some 
environment: 
EUREKA HOST: discovery 
EUREKA PORT: 8761 
SPRING PROFILES ACTIVE: docker 
ports: 
- "80:80" 


monitor: 
image: monitor:1.0.0-SNAPSHOT 
hostname: monitor 
links: 
- discovery 
- config 
- person 
- some 
- ui 
environment: 
EUREKA HOST: discovery 
EUREKA PORT: 8761 
SPRING PROFILES ACTIVE: docker 
# ports: 
# - "8989:8989" 


代码 解释 


Qenviroment: 给 容器 使 用 的 变量 ， 在 容器 中 
使 用 ${} 来 调用 。 


@links: 当前 容 侣 依赖 的 容 右 ， 可 直接 使 用 
依赖 容 右 的 已 有 病 口 。 


人 


@ports， 将 我 们 要 暴露 的 端口 映射 出 来 ， 不 
需要 暴露 的 端口 则 不 做 映射 。 


12.4.4 ”运行 


Tf docker-compose.yml E18 E Linux hkg z& 
E, EXIF Sa EDT Paga: 
docker-compose up -d 
-dz&zn/8 BIBI ° 


启动 运行 效果 如 图 12-14 所 示 。 


112]# docker-compose up -d 
Ilostgresdb 1 


3 
at : £ 
creating chl2_ 
Creating chi2 
Creating chi2_so 
Creating chi2_ui_1... 
Creating ch12 monitor 1... 


图 12-14 ”启动 运行 效果 


这 时 我 们 可 以 在 本 地 访问 
http://192.168.1.68: 8761 和 http://192.168.1.68， 分 
别 如 图 12-15 和 图 12-16 所 示 。 


Z6 
J 原生 云 应 用 x ) @ Eureka x 


fi D 192.168.1.68:8761 wHiuIG -S:z 


St 应 用 Apache Mesos vps Linux CJ docker Android DD Spring Hacking # FEAS Xx 设置 & 扩展 程序 » O 其 他 书签 


Application AMIs Availability Zones Status 

CONFIG n/a (1) (1) UP (1) - config:config:ea6c5c97fe4d9be98d16398c32aeb00e 
MONITOR n/a (1) (1) UP (1) - monitor 

PERSON n/a (1) (1) UP (1) - person 

SOME n/a (1) (1) UP (1) - some 

Ul n/a (1) (1) UP (1) - ui 


General Info 


Name Value 


total-avail-memory 865mb 


environment 


图 12-15 ”访问 效果 (http://192.168.1.68: 8761) 


fam - o x 
应 用 x \ ge Eureka x 
fi D 192.168.1.68/#/person wr 0 
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原生 云 应 上 Personi 


Some 服 务 


通过 Person Service 保 存 person 


十 与 名 于 


保存 


图 12-16 ”访问 效果 (http://192.168.1.68) 


BY SKA 


AJ 基于 JHipster 的 代码 生成 


JHipster 是 一 个 代码 生成 项 ， 可 以 用 来 生成 基 
于 Spring Boot 和 AngularJS 的 项 目 。 


1.2 Node JS 

下 载 地 址 : https://nodejs.org/download/ 

2. 安 装 Git 客 户 端 

下 载 地 址 : https://git-scm.com/download/win 
3.242 Yeoman generator 


npm install -g yo 


4.2 Hipster 


npm install -g generator-jhipster 


5.38 Bower 


npm install -g bower 


6. Z3 Grunt 


npm install -g grunt-cli 


7. 使 用 JHipster 生 成 项 目 


mkdir hello-boot 
cd hello-boot 
yo jhipster 


执行 下 面 代 码 ， 戏 果 如 图 A-1 所 示 。 


图 A-1 执行 效果 


按照 近 示 癌 导 进行 操作 ， 如 图 A-2 所 示 。 


图 A-2 ”按照 提示 癌 导 操作 


最 终 完 成 的 结果 如 图 A-3 所 示 。 


图 A-3 “完成 


生成 的 代码 文件 结构 如 图 A-4 所 示 。 


电脑 > 本 地 磁盘 (C) > 用 户 » wisely > hello-boot 


| | node modules 


= pom 


| README.md 


图 A-4 文件 结构 
8. 运 行 
在 程序 目 隶 下， 执行 下 面 代码 : 


mvn spring-boot:run 


访问 http://localhost: 8080， 效 果 如 图 A-5 所 


fe) 
ZJN 
mi 

g heloboot 

€-ch h £ 
it Fy Å Ho A 
ey 

Sy 


This is your homepage 


f= N Welcome, Java Hipster! 
CHA 
P 


7 you want to A e ale you an try me default acc Ants 
login-"user" and password="use 


图 A-5 访问 http://localhost: 8080 


以 账号 和 密码 都 为 admin 登 录 系 统 ，JHipster 
已 为 我 们 做 了 很 多 基础 的 工作 ， 如 图 A-6 所 示 。 


i Application Metrics x 
€ > C f L locathost:8080/#/metrics a= 


j 会 Home enves- BRAccount- — MeAGministrabon = 


Application Metrics 


EE su 


[E 
JVM Metrics B Database 
Memory Threads (Total 24) © Garbage collections 
Total Memory (250M / 1,879M) Runnable & Mark Sweep count 3 
" Mark Sweep time 404ms 

Ea x OD UM 
Heap Memory (140M / 1.879M) Timed Waiting (5) sire avn gines 
Non-Heap Memory (109M / 111M) waiting (11) 

Blocked (0) 
HTTP requests (events per second) 
Active requests 1 - Total requests 136 

focalhest S080 ean Average (1 min} Average (5 min) Average (15 min) re 


图 A-6 ”登录 系统 
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# COMMON SPRING BOOT PROPERTIES 


# 

# This sample file is provided as a guideline. Do NOT copy 
it in its 

# entirety to your own application. AAA 

# 

#. 

# CORE PROPERTIES 
并 

# BANNER 


banner.charset-UTF-8 # banner file encoding 
banner.location-classpath:banner.txt £ banner file location 


# SPRING CONFIG (ConfigFileApplicationListener 


) 

spring.config.name- # config file name (default to 
'application') 

spring.config.location- £ location of config file 


# PROFILES 
spring.profiles.active- # comma list of active profiles 


spring.profiles.include- £ unconditionally activate the 
specified comma separated profiles 


) 


spring.main.sources- £ sources (class name, package name or 
XML resource location) to include 
spring.main.web-environment- # detect by default 
spring.main.show-banner-true 

spring.main....- # see class for all properties 


# ADMIN (SpringApplicationAdminJmxAutoConfiguration 


) 


spring.application.admin.enabled-false £ enable admin 
features for the application 

spring.application.admin. jmx- 
name=org.springframework. boot: type=Admin, name=SpringApplicat 
ion # JMX name of the application admin MBean 


# OUTPUT 

spring.output.ansi.enabled=detect # Configure the ANSI 
output ("detect", "always", "never" ) 

# LOGGING 


logging. path=/var/logs 

logging. file=myapp.log 

logging.config- # location of config file (default 
classpath:logback.xml for logback) 

logging.level.*- £ levels for loggers, e.g. 
"logging.level.org.springframework-DEBUG" (TRACE, DEBUG, 
INFO, WARN, ERROR, FATAL, OFF) 


# IDENTITY (ContextIdApplicationContextInitializer 


) 
spring.application.name- 
spring.application.index- 


4 EMBEDDED SERVER CONFIGURATION (ServerProperties 


) 


server.port-8080 

server.address- # bind to a specific NIC 
server.session-timeout- # session timeout in seconds 
server.context-parameters.*- £ Servlet context init 
parameters, e.g. server.context-parameters.a-alpha 
server.context-path- £ the context path, defaults to '/' 


server.jsp-servlet.class- 

name-org.apache.jasper.servlet.JspServlet £ The class name 

of the JSP servlet 

server.jsp-servlet.init-parameters.*- # Init parameters used 

to configure the JSP servlet 

server.jsp-servlet.registered-true # Whether or not the JSP 

servlet is registered 

server.servlet-path- £ the servlet path, defaults to '/' 

server.display-name- £ the display name of the application 

server.ssl.enabled-true # if SSL support is enabled 

server.ssl.client-auth- # want or need 

server.ssl.key-alias- 

server.ssl.ciphers- # supported SSL ciphers 

server .ssl.key-password= 

server.ssl.key-store= 

server.ssl.key-store-password= 

server.ssl.key-store-provider= 

server.ssl.key-store-type= 

server.ssl.protocol=TLS 

server.ssl.trust-store= 

server.ssl.trust-store-password= 

server.ssl.trust-store-provider= 

server.ssl.trust-store-type= 

server .tomcat.access-log-pattern= # log pattern of the 

access log 

server .tomcat.access-log-enabled=false # is access logging 

enabled 

server.tomcat.compression=off # is compression enabled (off, 

on, or an integer content length limit) 

server .tomcat.compressable-mime- 

types=text/html, text/xml, text/plain # comma-separated list 

of mime types that Tomcat will compress 

server .tomcat.internal- 

proxies=10\\.\\d{1, 3}\\.\\d{1, 3}\\.\\d{1, 3} | \\ 
192\\.168\\.\\d{1, 3}\\.\\d{1, 3} | \\ 
169NN.254NN. NNd (1,3) NN. NNd(1,3) | \\ 
127\\.\\d{1, 3) NN. NNd(1, 39 NN. NNd(1,3) |NN 
172\\.1[6-9] (1) NN. NNd(1, 3) NN. NNd(1,3)|NN 
172NN.2[0-9] (1) NN. NNd(1, 3) NN. NNd(1, 3} |NN 
172NN.3[0-1] (1) NN. NNd(1, 3) NN.NNd(1,3) # regular 

expression matching trusted IP addresses 

server.tomcat.protocol-header-zx-forwarded-proto # front end 

proxy forward header 

server.tomcat.port-header- £ front end proxy port header 

server.tomcat.remote-ip-header-x-forwarded-for 


server.tomcat.basedir-/tmp £ base dir (usually not needed, 
defaults to tmp) 
server.tomcat.background-processor-delay-30; # in seconds 
server.tomcat.max-http-header-size- # maximum size in bytes 
of the HTTP message header 

server.tomcat.max-threads = 0 # number of threads in 
protocol handler 

server.tomcat.uri-encoding - UTF-8 £ character encoding to 
use for URL decoding 
server.undertow.access-log-enabled-false # if access logging 
is enabled 

server.undertow.access-log-pattern-common # log pattern of 
the access log 

server.undertow.access-log-dir-logs # access logs directory 
server.undertow.buffer-size- £ size of each buffer in bytes 
server.undertow.buffers-per-region- # number of buffer per 
region 

server.undertow.direct-buffers-false # allocate buffers 
outside the Java heap 

server.undertow.io-threads- # number of I/O threads to 
create for the worker 

server.undertow.worker-threads- # number of worker threads 


# SPRING MVC (WebMvcProperties 


) 


spring.mvc.locale- £ set fixed locale, e.g. en UK 
spring.mvc.date-format- # set fixed date format, e.g. 
dd/MM/yyyy 

spring.mvc.favicon.enabled-true 
spring.mvc.message-codes-resolver-format- £ 

PREFIX ERROR CODE / POSTFIX ERROR CODE 
spring.mvc.ignore-default-model-on-redirect-true # If the 
the content of the "default" model should be ignored 
redirects 

spring.view.prefix- £ MVC view prefix 
spring.view.suffix- # ... and suffix 


4 SPRING RESOURCES HANDLING (ResourceProperties 


) 


spring.resources.cache-period- £ cache timeouts in headers 
sent to browser 

spring.resources.add-mappings-true # if default mappings 
should be added 


# MULTIPART (MultipartProperties 


) 


multipart.enabled-true 

multipart.file-size-threshold=0 # Threshold after which 
files will be written to disk. 

multipart.location= # Intermediate location of uploaded 
files. 

multipart.max-file-size=1Mb # Max file size. 
multipart.max-request-size-10Mb # Max request size. 


# SPRING HATEOAS (HateoasProperties 


) 
spring.hateoas.apply-to-primary-object-mapper=true # if the 
primary mapper should also be configured 


# HTTP encoding (HttpEncodingProperties 


) 
spring.http.encoding.charset=UTF-8 # the encoding of HTTP 


requests/responses 

spring.http.encoding.enabled=true # enable http encoding 
support 

spring.http.encoding.force=true # force the configured 
encoding 


# HTTP message conversion 
spring.http.converters.preferred-json-mapper= # the 
preferred JSON mapper to use for HTTP message conversion. 
Set to "gson" to force the use of Gson when both it and 
Jackson are on the classpath. 


# HTTP response compression (GzipFilterProperties 


) 
spring.http.gzip.buffer-size- # size of the output buffer in 


bytes 

spring.http.gzip.deflate-compression-level- £ the level used 
for deflate compression (0-9) 
spring.http.gzip.deflate-no-wrap- # noWrap setting for 
deflate compression (true or false) 
spring.http.gzip.enabled=true # enable gzip filter support 
spring.http.gzip.excluded-agents= # comma-separated list of 


user agents to exclude from compression 
spring.http.gzip.exclude-agent-patterns- # comma-separated 
list of regular expression patterns to control user agents 
excluded from compression 

spring.http.gzip.exclude-paths- # comma-separated list of 
paths to exclude from compression 
spring.http.gzip.exclude-path-patterns- # comma-separated 
list of regular expression patterns to control the paths 
that are excluded from compression 

spring.http.gzip.methods- £ comma-separated list of HTTP 
methods for which compression is enabled 
spring.http.gzip.mime-types- £ comma-separated list of MIME 
types which should be compressed 
spring.http.gzip.excluded-mime-types- # comma-separated list 
of MIME types to exclude from compression 
spring.http.gzip.min-gzip-size- # minimum content length 
required for compression to occur 

spring.http.gzip.vary- £ Vary header to be sent on responses 
that may be compressed 


# JACKSON (JacksonProperties 


) 


spring.jackson.date-format- # Date format string (e.g. yyyy- 
MM-dd HH:mm:ss), or a fully-qualified date format class name 
(e.g. com.fasterxml.jackson.databind.util.ISO8601DateFormat) 
spring.jackson.property-naming-strategy- # One of the 
constants on Jackson's PropertyNamingStrategy (e.g. 

CAMEL CASE TO LOWER CASE WITH UNDERSCORES) or the fully- 
qualified class name of a PropertyNamingStrategy subclass 
spring.jackson.deserialization.*- £ see Jackson's 
DeserializationFeature 

spring.jackson.generator.*- # see Jackson's 
JsonGenerator.Feature 

spring.jackson.joda-date-time-format- # Joda date time 
format string 

spring.jackson.mapper.*- £ see Jackson's MapperFeature 
spring.jackson.parser.*- # see Jackson's JsonParser.Feature 
spring.jackson.serialization.*- £ see Jackson's 
SerializationFeature 

spring.jackson.serialization-inclusion- £ Controls the 
inclusion of properties during serialization (see Jackson's 
JsonInclude.Include) 


# THYMELEAF (ThymeleafAutoConfiguration 


) 


spring.thymeleaf.check-template-location-true 
spring.thymeleaf.prefix-classpath:/templates/ 
spring.thymeleaf.excluded-view-names- # comma-separated list 
of view names that should be excluded from resolution 
spring.thymeleaf.view-names- £ comma-separated list of view 
names that can be resolved 

spring.thymeleaf.suffix-.html 

spring.thymeleaf .mode=HTML5 

spring.thymeleaf.enabled=true # enable MVC view resolution 
spring.thymeleaf.encoding-UTF-8 
spring.thymeleaf.content-type-text/html # ;charset- 
«encoding» is added 

spring.thymeleaf.cache-true # set to false for hot refresh 


4 FREEMARKER (FreeMarkerAutoConfiguration 


) 


spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 


freemarker. 
freemarker. 
freemarker. 
.charset=UTF-8 
freemarker. 
freemarker. 
.expose-request-attributes-false 
freemarker. 
freemarker. 
freemarker. 
.request-context-attribute- 
freemarker. 
freemarker. 
freemarker. 


freemarker 


freemarker 


freemarker 


# comma-separated 


spring. 


can be 


freemarker 
resolved 


allow-request-override-false 
cache-true 
check-template-location-true 


content-type-text/html 
enabled-true # enable MVC view resolution 


expose-session-attributes-false 
expose-spring-macro-helpers-false 
prefix- 


settings.*- 

suffix-.ftl 
template-loader-path-classpath:/templates/ 
list 


.View-names- # whitelist of view names that 


# GROOVY TEMPLATES (GroovyTemplateAutoConfiguration 


) 


spring.groovy.template.cache-true 
spring.groovy.template.charset-UTF-8 
spring.groovy.template.check-template-location-true £ check 
that the templates location exists 
spring.groovy.template.configuration.*- # See 


GroovyMarkupConfigurer 


spring.groovy.template. 
spring.groovy.template. 


resolution 


spring.groovy.template. 
spring.groovy.template. 
spring.groovy.template. 


content-type-text/html 
enabled-true # enable MVC view 


prefix-classpath:/templates/ 
suffix-.tpl 
view-names- # whitelist of view names 


that can be resolved 


# VELOCITY TEMPLATES (VelocityAutoConfiguration 


) 

spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
system 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
config 
spring. 
can be 


velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 


allow-request-override-false 

cache-true 

check-template-location-true 
charset=UTF-8 

content-type-text/html 
date-tool-attribute- 

enabled-true # enable MVC view resolution 
expose-request-attributes-false 
expose-session-attributes-false 
expose-spring-macro-helpers-false 
number-tool-attribute- 
prefer-file-system-access-true £ prefer file 


access for template loading 


velocity. 
velocity. 
velocity. 
velocity. 
velocity. 
velocity. 


location, 


velocity. 


resolved 


prefix- 

properties.*- 

request-context-attribute- 

resource-loader -path=classpath:/templates/ 
suffix=.vm 

toolbox-config-location= # velocity Toolbox 
for example "/WEB-INF/toolbox. xml" 

view-names= # whitelist of view names that 


# MUSTACHE TEMPLATES (MustacheAutoConfiguration 


) 

spring 
spring 
spring 
spring 
spring 
spring 
spring 


.mustache. 
.mustache. 
.mustache. 
.mustache. 
.mustache. 
.mustache. 
.mustache. 


cache=true 

charset=UTF-8 
check-template-location=true 

content -type=UTF-8 

enabled=true # enable MVC view resolution 
prefix- 

suffix-.html 


spring.mustache.view-names- # whitelist of view names 


that 


can be resolved 


# JERSEY 


) 


(JerseyProperties 


spring.jersey.type-servlet £ servlet or filter 
spring.jersey.init- # init params 
spring.jersey.filter.order= 


# INTERNATIONALIZATION (MessageSourceAutoConfiguration 


) 


spring.messages.basename=messages 
spring.messages.cache-seconds=-1 
spring.messages.encoding-UTF-8 


# SECURITY (SecurityProperties 


) 


security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
stateless 
security. 


from the 


4 OAuth2 


user.name-user £ login username 

user.password- £ login password 

user.role-USER £ role assigned to the user 
require-ssl-false # advanced settings 
enable-csrf-false 

basic.enabled-true 

basic.realm-Spring 

basic.path- # /** 

basic.authorize-mode- £ ROLE, AUTHENTICATED, NONE 
filter-order=0 

headers.xss=false 

headers.cache=false 

headers. frame=false 

headers.content-type=false 

headers.hsts=all # none / domain / all 
sessions=stateless # always / never / if_required / 


ignored= # Comma-separated list of paths to exclude 
default secured paths 


client (OAuth2ClientProperties 


spring.oauth2.client.client-id- # OAuth2 client id 


spring.oauth2.client.client-secret- # OAuth2 client secret. 
A random secret is generated by default 


# OAuth2 SSO (OAuth2SsoProperties 


spring.oauth2.sso.filter-order- # Filter order to apply if 
not providing an explicit WebSecurityConfigurerAdapter 
spring.oauth2.sso.login-path- # Path to the login page, i.e. 
the one that triggers the redirect to the OAuth2 
Authorization Server 


# DATASOURCE (DataSourceAutoConfiguration 


& DataSourceProperties 


) 


spring.datasource.name= # name of the data source 
spring.datasource.initialize=true # populate using data.sql 
spring.datasource.schema= # a schema (DDL) script resource 
reference 

spring.datasource.data- # a data (DML) script resource 
reference 

spring.datasource.sql-script-encoding- # a charset for 
reading SQL scripts 

spring.datasource.platform= # the platform to use in the 
schema resource (schema-${platform}.sql) 
spring.datasource.continue-on-error=false # continue even if 
can't be initialized 

spring.datasource.separator=; # statement separator in SQL 
initialization scripts 

spring.datasource.driver-class-name= # JDBC Settings... 
spring.datasource.url= 

spring.datasource.username= 

spring.datasource.password= 

spring.datasource.jndi-name= # For JNDI lookup (class, url, 
username & password are ignored when set) 
spring.datasource.max-active=100 # Advanced configuration... 
spring.datasource.max-idle=8 

spring.datasource.min-idle=8 
spring.datasource.initial-size-10 
spring.datasource.validation-query- 
spring.datasource.test-on-borrow-false 
spring.datasource.test-on-return-false 
spring.datasource.test-while-idle- 


spring.datasource.time-between-eviction-runs-millis- 
spring.datasource.min-evictable-idle-time-millis- 
spring.datasource.max-wait- 
spring.datasource.jmx-enabled-false # Export JMX MBeans (if 
supported) 


# DAO (PersistenceExceptionTranslationAutoConfiguration 


) 


spring.dao.exceptiontranslation.enabled-true 


# MONGODB (MongoProperties 


) 
spring.data.mongodb.host- # the db host 


spring.data.mongodb.port-27017 # the connection port 
(defaults to 27107) 
spring.data.mongodb.uri=mongodb://localhost/test # 
connection URL 

spring.data.mongodb.database- 
spring.data.mongodb.authentication-database- 
spring.data.mongodb.grid-fs-database- 
spring.data.mongodb.username- 
spring.data.mongodb.password- 
spring.data.mongodb.repositories.enabled-true £ if spring 
data repository support is enabled 


# JPA (JpaBaseConfiguration 


, HibernateJpaAutoConfiguration 


) 

spring.jpa.properties.*= # properties to set on the JPA 
connection 

spring.jpa.open-in-view=true 

spring.jpa.show-sql-true 

spring.jpa.database-platform- 

spring.jpa.database- 

spring.jpa.generate-ddl-false # ignored by Hibernate, might 
be useful for other vendors 
spring.jpa.hibernate.naming-strategy- £ naming classname 
spring.jpa.hibernate.ddl-auto- £ defaults to create-drop for 
embedded dbs 

spring.data.jpa.repositories.enabled-true £ if spring data 
repository support is enabled 


# JTA (JtaAutoConfiguration 


) 
spring.jta.log-dir- # transaction log dir 
spring.jta.*- # technology specific configuration 


# ATOMIKOS 
spring.jta.atomikos.connectionfactory.borrow-connection- 
timeout-30 £ Timeout, in seconds, for borrowing connections 
from the pool 
spring.jta.atomikos.connectionfactory.ignore-session- 
transacted-flag-true # Whether or not to ignore the 
transacted flag when creating session 
spring.jta.atomikos.connectionfactory.local-transaction- 
mode-false # Whether or not local transactions are desired 
spring.jta.atomikos.connectionfactory.maintenance- 
interval-60 # The time, in seconds, between runs of the 
pool's maintenance thread 
spring.jta.atomikos.connectionfactory.max-idle-time-60 # The 
time, in seconds, after which connections are cleaned up 
from the pool 
spring.jta.atomikos.connectionfactory.max-lifetime=0 # The 
time, in seconds, that a connection can be pooled for before 
being destroyed. © denotes no limit. 
spring.jta.atomikos.connectionfactory.max-pool-size=1 # The 
maximum size of the pool 
spring.jta.atomikos.connectionfactory.min-pool-size=1 # The 
minimum size of the pool 
spring.jta.atomikos.connectionfactory.reap-timeout=0 # The 
reap timeout, in seconds, for borrowed connections. 0 
denotes no limit. 
spring.jta.atomikos.connectionfactory.unique-resource- 
name=jmsConnectionFactory # The unique name used to identify 
the resource during recovery 
spring.jta.atomikos.datasource.borrow-connection-timeout-30 
# Timeout, in seconds, for borrowing connections from the 
pool 

spring.jta.atomikos.datasource.default-isolation-level- £ 
Default isolation level of connections provided by the pool 
spring.jta.atomikos.datasource.login-timeout- £ Timeout, in 
seconds, for establishing a database connection 
spring.jta.atomikos.datasource.maintenance-interval-60 # The 
time, in seconds, between runs of the pool's maintenance 
thread 


spring.jta.atomikos.datasource.max-idle-time-60 # The time, 
in seconds, after which connections are cleaned up from the 
pool 

spring.jta.atomikos.datasource.max-lifetime-O £ The time, in 
seconds, that a connection can be pooled for before being 
destroyed. O denotes no limit. 
spring.jta.atomikos.datasource.max-pool-size=1 # The maximum 
size of the pool 
spring.jta.atomikos.datasource.min-pool-size=1 # The minimum 
size of the pool 
spring.jta.atomikos.datasource.reap-timeout=0 # The reap 
timeout, in seconds, for borrowed connections. © denotes no 
limit. 

spring.jta.atomikos.datasource.test-query= # SQL query or 
statement used to validate a connection before returning it 
spring.jta.atomikos.datasource.unique-resource- 
name=dataSource # The unique name used to identify the 
resource during recovery 


# BITRONIX 
spring.jta.bitronix.connectionfactory.acquire-increment=1 # 
Number of connections to create when growing the pool 
spring.jta.bitronix.connectionfactory.acquisition-interval=1 
# Time, in seconds, to wait before trying to acquire a 
connection again after an invalid connection was acquired 
spring.jta.bitronix.connectionfactory.acquisition-timeout=30 
# Timeout, in seconds, for acquiring connections from the 
pool 

spring.jta.bitronix.connectionfactory.allow-local- 
transactions-true £ Whether or not the transaction manager 
should allow mixing XA and non-XA transactions 
spring.jta.bitronix.connectionfactory.apply-transaction- 
timeout-false # Whether or not the transaction timeout 
should be set on the XAResource when it is enlisted 
spring.jta.bitronix.connectionfactory.automatic-enlisting- 
enabled-true £ Whether or not resources should be enlisted 
and delisted automatically 
spring.jta.bitronix.connectionfactory.cache-producers- 
consumers-true £ Whether or not produces and consumers 
should be cached 
spring.jta.bitronix.connectionfactory.defer-connection- 
release-true # Whether or not the provider can run many 
transactions on the same connection and supports transaction 
interleaving 
spring.jta.bitronix.connectionfactory.ignore-recovery- 


failures-false £ Whether or not recovery failures should be 
ignored 
spring.jta.bitronix.connectionfactory.max-idle-time-60 # The 
time, in seconds, after which connections are cleaned up 
from the pool 
spring.jta.bitronix.connectionfactory.max-pool-size-10 # The 
maximum size of the pool. 0 denotes no limit 
spring.jta.bitronix.connectionfactory.min-pool-size=0 # The 
minimum size of the pool 
spring.jta.bitronix.connectionfactory.password= # The 
password to use to connect to the JMS provider 
spring.jta.bitronix.connectionfactory.share-transaction- 
connections=false # Whether or not connections in the 
ACCESSIBLE state can be shared within the context of a 
transaction 
spring.jta.bitronix.connectionfactory.test-connections-true 
# Whether or not connections should be tested when acquired 
from the pool 
spring.jta.bitronix.connectionfactory.two-pc-ordering- 
position-1 £ The postion that this resource should take 
during two-phase commit (always first is Integer.MIN VALUE, 
always last is Integer.MAX VALUE) 
spring.jta.bitronix.connectionfactory.unique- 
name-jmsConnectionFactory # The unique name used to identify 
the resource during recovery 
spring.jta.bitronix.connectionfactory.use-tm-join-true 
Whether or not TMJOIN should be used when starting 
XAResources 

spring.jta.bitronix.connectionfactory.user- £ The user to 
use to connect to the JMS provider 
spring.jta.bitronix.datasource.acquire-increment=1 # Number 
of connections to create when growing the pool 
spring.jta.bitronix.datasource.acquisition-interval=1 # 
Time, in seconds, to wait before trying to acquire a 
connection again after an invalid connection was acquired 
spring.jta.bitronix.datasource.acquisition-timeout=30 # 
Timeout, in seconds, for acquiring connections from the pool 
spring.jta.bitronix.datasource.allow-local-transactions=true 
# Whether or not the transaction manager should allow mixing 
XA and non-XA transactions 
spring.jta.bitronix.datasource.apply-transaction- 
timeout-false # Whether or not the transaction timeout 
should be set on the XAResource when it is enlisted 
spring.jta.bitronix.datasource.automatic-enlisting- 
enabled=true # Whether or not resources should be enlisted 


and delisted automatically 
spring.jta.bitronix.datasource.cursor-holdability- # The 
default cursor holdability for connections 
spring.jta.bitronix.datasource.defer-connection-release-true 
# Whether or not the database can run many transactions on 
the same connection and supports transaction interleaving 
spring.jta.bitronix.datasource.enable-jdbc4-connection-test 
# Whether or not Connection.isValid() is called when 
acquiring a connection from the pool 
spring.jta.bitronix.datasource.ignore-recovery- 
failures-false # Whether or not recovery failures should be 
ignored 

spring.jta.bitronix.datasource.isolation-level- £ The 
default isolation level for connections 
spring.jta.bitronix.datasource.local-auto-commit # The 
default auto-commit mode for local transactions 
spring.jta.bitronix.datasource.login-timeout- £ Timeout, in 
seconds, for establishing a database connection 
spring.jta.bitronix.datasource.max-idle-time-60 # The time, 
in seconds, after which connections are cleaned up from the 
pool 

spring.jta.bitronix.datasource.max-pool-size-10 £ The 
maximum size of the pool. 0 denotes no limit 
spring.jta.bitronix.datasource.min-pool-size=0 # The minimum 
size of the pool 
spring.jta.bitronix.datasource.prepared-statement-cache- 
size=0 # The target size of the prepared statement cache. 0 
disables the cache 
spring.jta.bitronix.datasource.share-transaction- 
connections-false # Whether or not connections in the 
ACCESSIBLE state can be shared within the context of a 
transaction 

spring.jta.bitronix.datasource.test-query # SQL query or 
statement used to validate a connection before returning it 
spring.jta.bitronix.datasource.two-pc-ordering-position-1 £ 
The position that this resource should take during two-phase 
commit (always first is Integer.MIN VALUE, always last is 
Integer.MAX VALUE) 
spring.jta.bitronix.datasource.unique-name-dataSource £ The 
unique name used to identify the resource during recovery 
spring.jta.bitronix.datasource.use-tm-join-true Whether or 
not TMJOIN should be used when starting XAResources 


& SOLR ( 


SolrProperties 


) 
spring.data.solr.host=http://127.0.0.1:8983/solr 


spring.data.solr.zk-host= 
spring.data.solr.repositories.enabled=true # if spring data 
repository support is enabled 


# ELASTICSEARCH (ElasticsearchProperties 


) 


spring.data.elasticsearch.cluster-name= # The cluster name 
(defaults to elasticsearch) 
spring.data.elasticsearch.cluster-nodes= # The address(es) 
of the server node (comma-separated; if not specified starts 
a client node) 

spring.data.elasticsearch.properties.*= # Additional 
properties used to configure the client 
spring.data.elasticsearch.repositories.enabled=true # if 
spring data repository support is enabled 


# DATA REST (RepositoryRestConfiguration 


) 


spring.data.rest.base-path= # base path against which the 
exporter should calculate its links 


# FLYWAY (FlywayProperties 


) 
flyway.*- # Any public property available on the auto- 


configured ‘Flyway object 

flyway.check-location-false # check that migration scripts 
location exists 

flyway.locations-classpath:db/migration # locations of 
migrations scripts 

flyway.schemas- # Schemas to update 

flyway.init-version- 1 £ version to start migration 
flyway.init-sqls= # SQL statements to execute to initialize 
a connection immediately after obtaining it 
flyway.sql-migration-prefix-V 
flyway.sql-migration-suffix=.sql 

flyway.enabled-true 

flyway.url- # JDBC url if you want Flyway to create its own 
DataSource 


flyway.user- # JDBC username if you want Flyway to create 
its own DataSource 

flyway.password- # JDBC password if you want Flyway to 
create its own DataSource 


# LIQUIBASE (LiquibaseProperties 


) 
liquibase.change-log-classpath:/db/changelog/db.changelog- 


master.yaml 

liquibase.check-change-log-location-true # check the change 
log location exists 

liquibase.contexts- # runtime contexts to use 
liquibase.default-schema- # default database schema to use 
liquibase.drop-first-false 

liquibase.enabled-true 

liquibase.url- # specific JDBC url (if not set the default 
datasource is used) 

liquibase.user- # user name for liquibase.url 
liquibase.password- # password for liquibase.url 


# JMX 

spring.jmx.default-domain- # JMX domain name 
spring.jmx.enabled-true # Expose MBeans from Spring 
spring.jmx.mbean-server=mBeanServer # MBeanServer bean name 


# RABBIT (RabbitProperties 


) 


spring.rabbitmq.addresses- £ connection addresses (e.g. 
myhost:9999, otherhost:1111) 

spring.rabbitmq.dynamic-true £ create an AmqpAdmin bean 
spring.rabbitmq.host- # connection host 
spring.rabbitmq.port- # connection port 
spring.rabbitmq.password- # login password 
spring.rabbitmq.requested-heartbeat- # requested heartbeat 
timeout, in seconds; zero for none 
spring.rabbitmq.ssl.enabled-false # enable SSL support 
spring.rabbitmq.ssl.key-store- £ path to the key store that 
holds the SSL certificate 
spring.rabbitmq.ssl.key-store-password- # password used to 
access the key store 

spring.rabbitmq.ssl.trust-store- £ trust store that holds 
SSL certificates 

spring.rabbitmq.ssl.trust-store-password- £ password used to 


access the trust store 

spring.rabbitmq.username- £ login user 
spring.rabbitmq.virtual-host- £ virtual host to use when 
connecting to the broker 


# REDIS (RedisProperties 


) 


spring.redis.database- £ database name 
spring.redis.host-localhost # server host 
spring.redis.password- £ server password 
spring.redis.port-6379 # connection port 
spring.redis.pool.max-idle-8 £ pool settings 
spring.redis.pool.min-idle=0 
spring.redis.pool.max-active=8 
spring.redis.pool.max-wait=-1 
spring.redis.sentinel.master= # name of Redis server 
spring.redis.sentinel.nodes= # comma-separated list of 
host:port pairs 

spring.redis.timeout= # connection timeout in milliseconds 


# ACTIVEMQ (ActiveMQProperties 


) 
spring.activemq.broker-url=tcp://localhost:61616 # 


connection URL 

spring.activemq.user= 

spring.activemq.password- 

spring.activemq.in-memory-true # broker kind to create if no 
broker-url is specified 

spring.activemq.pooled-false 


# HornetQ (HornetQProperties 


) 


spring.hornetq.mode- # connection mode (native, embedded) 
spring.hornetq.host-localhost £ hornetQ host (native mode) 
spring.hornetq.port-5445 £ hornetQ port (native mode) 
spring.hornetq.embedded.enabled-true # if the embedded 
server is enabled (needs hornetq-jms-server.jar) 
spring.hornetq.embedded.server-id- £ auto-generated id of 
the embedded server (integer) 
spring.hornetq.embedded.persistent-false # message 
persistence 

spring.hornetq.embedded.data-directory- £ location of data 


content (when persistence is enabled) 
spring.hornetq.embedded.queues- £ comma-separated queues to 
create on startup 

spring.hornetq.embedded.topics- # comma-separated topics to 
create on startup 

spring.hornetq.embedded.cluster-password- # customer 
password (randomly generated by default) 


# JMS (JmsProperties 


) 


spring.jms.jndi-name= # JNDI location of a JMS 
ConnectionFactory 

spring.jms.pub-sub-domain= # false for queue (default), true 
for topic 


# Email (MailProperties 


) 


spring.mail.host=smtp.acme.org # mail server host 
spring.mail.port= # mail server port 
spring.mail.username= 

spring.mail.password= 

spring.mail.default-encoding-UTF-8 # encoding to use for 
MimeMessages 

spring.mail.properties.*= # properties to set on the 
JavaMail session 

spring.mail.jndi-name= # JNDI location of a Mail Session 


# SPRING BATCH (Ba 


tchProperties 


) 

spring.batch.job.names-job1, job2 
spring.batch.job.enabled-true 
spring.batch.initializer.enabled-true 

spring.batch.schema- # batch schema to load 
spring.batch.table-prefix- £ table prefix for all the batch 
meta-data tables 


4 SPRING CACHE (CacheProperties 


) 


spring.cache.type- # generic, ehcache, hazelcast, 


infinispan, jcache, redis, guava, simple, none 
spring.cache.cache-names- £ cache names to create on startup 
spring.cache.ehcache.config- £ location of the ehcache 
configuration 

spring.cache.hazelcast.config- # location of the hazelcast 
configuration 

spring.cache.infinispan.config- # location of the infinispan 
configuration 

spring.cache.jcache.config- # location of jcache 
configuration 

spring.cache.jcache.provider- £ fully qualified name of the 
CachingProvider implementation to use 
spring.cache.guava.spec- £ guava specs 


# AOP 
spring.aop.auto= 
spring.aop.proxy-target-class= 


# FILE ENCODING (FileEncodingApplicationListener 


) 
spring.mandatory-file-encoding= # Expected character 
encoding the application must use 


# SPRING SOCIAL (SocialWebAutoConfiguration 


) 


spring.social.auto-connection-views=true # Set to true for 
default connection views or false if you provide your own 


# SPRING SOCIAL FACEBOOK (FacebookAutoConfiguration 


) 


spring.social.facebook.app-id= # your application's Facebook 
App ID 

spring.social.facebook.app-secret= # your application's 
Facebook App Secret 


# SPRING SOCIAL LINKEDIN (LinkedInAutoConfiguration 


) 
spring.social.linkedin.app-id= # your application's LinkedIn 
App ID 


spring.social.linkedin.app-secret- £ your application's 
LinkedIn App Secret 


4 SPRING SOCIAL TWITTER (TwitterAutoConfiguration 


) 


spring.social.twitter.app-id- £ your application's Twitter 
App ID 

spring.social.twitter.app-secret- £ your application's 
Twitter App Secret 


# SPRING MOBILE SITE PREFERENCE 
(SitePreferenceAutoConfiguration 


) 


spring.mobile.sitepreference.enabled-true # enabled by 
default 


# SPRING MOBILE DEVICE VIEWS 
(DeviceDelegatingViewResolverAutoConfiguration 


) 


spring.mobile.devicedelegatingviewresolver.enabled-true £ 
disabled by default 
spring.mobile.devicedelegatingviewresolver.enable-fallback- 
# enable support for fallback resolution, default to false. 
spring.mobile.devicedelegatingviewresolver.normal-prefix- 
spring.mobile.devicedelegatingviewresolver.normal-suffix- 
spring.mobile.devicedelegatingviewresolver.mobile- 
prefix-mobile/ 
spring.mobile.devicedelegatingviewresolver.mobile-suffix- 
spring.mobile.devicedelegatingviewresolver.tablet- 
prefix-tablet/ 
spring.mobile.devicedelegatingviewresolver.tablet-suffix- 


# DEVTOOLS (DevToolsProperties 


) 


spring.devtools.restart.enabled-true # enable automatic 
restart 
spring.devtools.restart.exclude- £ patterns that should be 


excluding for triggering a full restart 
spring.devtools.restart.poll-interval- # amount of time (in 
milliseconds) to wait between polling for classpath changes 
spring.devtools.restart.quiet-period- £ amount of quiet time 
(in milliseconds) requited without any classpath changes 
before a restart is triggered 
spring.devtools.restart.trigger-file- # name of a specific 
file that when changed will trigger the restart 
spring.devtools.livereload.enabled-true # enable a 
livereload.com compatible server 
spring.devtools.livereload.port-35729 £ server port. 


# REMOTE DEVTOOLS (RemoteDevToolsProperties 


) 


spring.devtools.remote.context-path=/.~~spring-boot!~ £ 
context path used to handle the remote connection 
spring.devtools.remote.debug.enabled-true £ enable remote 
debug support 

spring.devtools.remote.debug.local-port-8000 # local remote 
debug server port 
spring.devtools.remote.restart.enabled-true £ enable remote 
restart 

spring.devtools.remote.secret- # a shared secret required to 
establish a connection 
spring.devtools.remote.secret-header-name-X-AUTH-TOKEN # 
HTTP header used to transfer the shared secret 


4 MANAGEMENT HTTP SERVER (ManagementServerProperties 


) 


management.port- # defaults to 'server.port' 
management.address- £ bind to a specific NIC 
management.context-path- # default to '/' 
management.add-application-context-header- # default to true 
management.security.enabled-true # enable security 
management.security.role-ADMIN £ role required to access the 
management endpoint 

management.security.sessions-stateless £ session creating 
policy to use (always, never, if required, stateless) 


# PID FILE (ApplicationPidFilewriter 


) 
spring.pidfile= # Location of the PID file to write 


# ENDPOINTS (AbstractEndpoint 


subclasses) 
endpoints.autoconfig.id=autoconfig 
endpoints.autoconfig.sensitive=true 
endpoints.autoconfig.enabled=true 
endpoints.beans.id=beans 
endpoints.beans.sensitive=true 
endpoints.beans.enabled=true 
endpoints.configprops.id=configprops 
endpoints.configprops.sensitive=true 
endpoints.configprops.enabled=true 
endpoints.configprops.keys-to-sanitize=password, secret, key # 
suffix or regex 
endpoints.dump.id=dump 
endpoints.dump.sensitive=true 
endpoints.dump.enabled=true 
endpoints.enabled=true # enable all endpoints 
endpoints.env.id=env 
endpoints.env.sensitive=true 
endpoints.env.enabled=true 
endpoints.env.keys-to-sanitize-password,secret,key # suffix 
or regex 
endpoints.health.id-health 
endpoints.health.sensitive-true 
endpoints.health.enabled-true 
endpoints.health.mapping.*- # mapping of health statuses to 
HttpStatus codes 
endpoints.health.time-to-live-1000 
endpoints.info.id-info 
endpoints.info.sensitive-false 
endpoints.info.enabled-true 
endpoints.mappings.enabled-true 
endpoints.mappings.id-mappings 
endpoints.mappings.sensitive-true 
endpoints.metrics.id-metrics 
endpoints.metrics.sensitive-true 
endpoints.metrics.enabled-true 
endpoints.shutdown.id-shutdown 
endpoints.shutdown.sensitive-true 


endpoints.shutdown.enabled-false 
endpoints.trace.id-trace 
endpoints.trace.sensitive-true 
endpoints.trace.enabled-true 


# ENDPOINTS CORS CONFIGURATION (MvcEndpointCorsProperties 


) 


endpoints.cors.allow-credentials- # set whether user 
credentials are support. When not set, credentials are not 
supported. 

endpoints.cors.allowed-origins- # comma-separated list of 
origins to allow. * allows all origins. When not set, CORS 
support is disabled. 

endpoints.cors.allowed-methods- # comma-separated list of 
methods to allow. * allows all methods. When not set, 
defaults to GET. 

endpoints.cors.allowed-headers- # comma-separated list of 
headers to allow in a request. * allows all headers. 
endpoints.cors.exposed-headers- # comma-separated list of 
headers to include in a response. 
endpoints.cors.max-age-1800 # how long, in seconds, the 
response from a pre-flight request can be cached by clients. 


4 HEALTH INDICATORS (previously health.*) 
management.health.db.enabled-true 
management.health.elasticsearch.enabled-true 
management.health.elasticsearch.indices- # comma-separated 
index names 

management .health.elasticsearch.response-timeout=100 # the 
time, in milliseconds, to wait for a response from the 
cluster 

management .health.diskspace.enabled=true 

management .health.diskspace.path=. 

management .health.diskspace. threshold=10485760 

management .health.jms.enabled=true 

management .health.mail.enabled=true 

management .health.mongo.enabled=true 
management .health. rabbit .enabled=true 

management ..health.redis.enabled=true 

management .health.solr.enabled=true 

management .health.status.order=DOWN, OUT OF SERVICE, 
UNKNOWN, UP 


# MVC ONLY ENDPOINTS 


endpoints.jolokia.path-/jolokia 
endpoints.jolokia.sensitive-true 
endpoints.jolokia.enabled-true £ when using Jolokia 


# JMX ENDPOINT (EndpointMBeanExportProperties 


) 


endpoints.jmx.enabled-true £ enable JMX export of all 
endpoints 

endpoints.jmx.domain- # the JMX domain, defaults to 
'org.springboot' 

endpoints.jmx.unique-names-false 
endpoints.jmx.static-names- 


# JOLOKIA (JolokiaProperties 


) 


jolokia.config.*- # See Jolokia manual 


# REMOTE SHELL 

shell.auth=simple # jaas, key, simple, spring 
shell.command-refresh-interval=-1 
shell.command-path-patterns- # classpath*:/commands/**, 
classpath*:/crash/commands/** 
shell.config-path-patterns- # classpath*:/crash/* 
shell.disabled-commands=jpa*, jdbc*, jndi* # comma-separated 
list of commands to disable 
shell.disabled-plugins=false # don't expose plugins 
shell.ssh.enabled= # ssh settings ... 
shell.ssh.key-path- 

shell.ssh.port- 

shell.telnet.enabled- £ telnet settings 
shell.telnet.port- 

shell.auth.jaas.domain- # authentication settings ... 
shell.auth.key.path- 

shell.auth.simple.user.name- 
shell.auth.simple.user.password- 
shell.auth.spring.roles- 


# METRICS EXPORT (MetricExportProperties 


) 


spring.metrics.export.enabled-true # flag to disable all 
metric exports (assuming any MetricWriters are available) 
spring.metrics.export.delay-millis-5000 # delay in 


milliseconds between export ticks 
spring.metrics.export.send-latest-true # flag to switch off 
any available optimizations based on not exporting unchanged 
metric values 

spring.metrics.export.includes- # list of patterns for 
metric names to include 

spring.metrics.export.excludes- # list of patterns for 
metric names to exclude. Applied after the includes 
spring.metrics.export.redis.aggregate-key-pattern- # pattern 
that tells the aggregator what to do with the keys from the 
source repository 
spring.metrics.export.redis.prefix-spring.metrics # prefix 
for redis repository if active 
spring.metrics.export.redis.key-keys.spring.metrics £ key 
for redis repository export (if active) 
spring.metrics.export.triggers.*- £ specific trigger 
properties per MetricWriter bean name 


# SENDGRID (SendGridAutoConfiguration 


) 


spring.sendgrid.username- # SendGrid account username 
spring.sendgrid.password- # SendGrid account password 
spring.sendgrid.proxy.host- # SendGrid proxy host 
spring.sendgrid.proxy.port- # SendGrid proxy port 


# GIT INFO 
spring.git.properties= # resource ref to generated git info 
properties file 


